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NOTATIONAL CONVENTIONS 

The following notatlonal conventions are used in this data book: 

Signal names are shown in all uppercase letters. For example, XD. 

A bar over a signal name indicates an active low signal. For example, OE. 

n-m indicates a bit field from bit n to bit m. For example, 7-0 specifies bits 7 through 0, inclusive. 

n:m indicates a signal (pin) range from n to m. For example D[7:01 specifies data lines 7 through 0, inclusive 

Use of a trailing letter H indicates a hexadecimal number. For example, 7AH is a hexadecimal number. 

Use of a trailing letter b indicates a binary number. For example, 010b is a binary number. 

When numerical modifiers such as K or M are used, they refer to binary rather than decimal form. Thus, for example, 1 KByte would be 
equivalent to 1024, not 1,000 bytes. 


NOTICES 
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Section 1: Introduction 


1.1 OVERVIEW OF THIS DATA 
BOOKLET 

This data booklet largely describes the areas in 
which the S3® Vision968^^ multimedia accelera¬ 
tor (hereinafter referred to as the Vislon968) is 
different from the S3 Vlslon964™ (hereinafter re¬ 
ferred to as the Vision964). 

The entire enhanced mode programming section 
Is included in this data booklet because it has 
been extensively revised from that in the 
Vislon964 data book. Similarly, the entire electri¬ 
cal data section is Included. For Information on 
other common features between the Vision968 
and Vision964, including most of the registers 
and the graphics acceleration functionality, see 
the Vision964 Graphics Accelerator Data Book. In 
particular, note that the pinout and pin descrip¬ 
tions are the same for both chips. 

1.2 PRODUCT OVERVIEW 

In general, the Vlsion968 provides all the features 
found in the Vislon964. The exception is that 
backward compatibility support for CGA, MDA 
and HGC is no longer provided in hardware. 

The Vlsion968 provides a number of enhanced 
capabilities notfound In the Vlsion964. These are 
summarized below and are described in detail in 
subsequent sections. 

1.3 ENHANCED VRAM SUPPORT 

The Vision968 supports single cycle EDO opera¬ 
tion at speeds up to 50 MHz. This provide the 


capability for sequential read or write data trans¬ 
fers at rates approaching twice that of convention 
fast page mode VRAMs. 

1.4 PACKED PIXEL ACCELERATION 

The Vision968 provides packed 24 bits/pixel (true 
color) acceleration. This means that each pixel in 
24 bits/pixel modes now occupies 3 bytes of 
memory Instead of 4 for the Vision964. In addi¬ 
tion, the graphics engine can process more pixels 
in a given number of clock cycles than for the 
Vision964. 

1.5 ENHANCED MEMORY-MAPPED 
I/O IMPLEMENTATION 

The Vision964 provides memory-mapped I/O 
(MMIO) access to certain enhanced command 
registers at fixed memory addresses. The 
Vision968 provides the following enhancements 
to this scheme: 

• The base address for MMIO is now the 
same as for linear addressing and Is relo¬ 
catable for plug and play support 

• The new MMIO is enabled at power-on 
reset for PCI systems, allowing the PCI 
subsystem to configure the Vision968 
without accessing the VGA registers 
through the I/O space 

• All registers are now memory mapped 

• Related 16-bit Enhanced command regis¬ 
ters are packed into 32-bit registers to re¬ 
duce the number of CPU cycles required 
to access them 
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• There are two apertures into the MMIO 
address space. One provides little en¬ 
dian (lntel®-style) access and the other 
provides big endian (Motorola®/ 
PowerPC™-style) access 

1.6 NEW DRAWING COMMANDS 

The following drawing commands have been 
added to those available with the Vision964: 

• polyline/2-point line 

• polygon with solid or patterned fills 

• trapezoid with solid or patterned fills 
(Bresenham parameters in hardware) 

• trapezoid with solid or patterned fills 
(Bresenham parameters specified by pro¬ 
grammer) 

• ROPBLT - Support is provided for the 
full set of 256 triadic raster operations 
for BitBLTs (as defined by Microsoft®) 

1.7 PCI SUPPORT ENHANCEMENTS 

The following have been added to Improve op¬ 
eration in PCI systems: 

• New registers for interrupt handling 

• Complete RAMDAC snooping capability 

• PCI disconnect based on the command 
FIFO status 

1.8 VIDEO ENGINE 

The Video Engine integrated into the Vision968 
can convert a YUV data stream to an RGB data 
stream. The output of the color space converter 
isthen sentthrough the scaling engineforscaling 
up or down. Additionally, a dithering engine con¬ 
verts 24 bits/pixel images to a 16- or 8- bit format 
(and 16-blt images to an 8-bit format) with little 
quality Impact. To support image compression, 
the Video Engine can scale images down to the 
size required to meet disk drive bandwidth re¬ 
quirements. 


1.9 RESOLUTIONS SUPPORTED 

Supported resolutions are shown in the follow¬ 
ing table. Extended VGA text modes up to 132 
columns by 43 rows are possible as well. 


Table 1-1. Video Resolutions Supported 



VRAM (MBytes) 

Resolution 

1 

2 

4 

8 

640x480x4 

✓ 

✓ 

✓ 

✓ 

640x480x8 

✓ 

✓ 

✓ 

✓ 

640x480x16 

✓ 

✓ 

✓ 

✓ 

640x480x24 

✓ 

✓ 

✓ 

✓ 

640x480x32 


✓ 

✓ 

✓ 

800x600x4 

✓ 

✓ 

✓ 

✓ 

800x600x8 

✓ 

✓ 

✓ 

✓ 

800x600x16 

✓ 

✓ 

✓ 

✓ 

800x600x24/32 


✓ 

✓ 

✓ 

1024x768x4 

✓ 

✓ 

✓ 

✓ 

1024x768x8 

✓ 

✓ 

✓ 

✓ 

1024x768x16 


✓ 

✓ 

✓ 

1024x768x24/32 



✓ 

✓ 

1152x864x8 

✓ 

4 

✓ 

✓ 

1280x1024x4 

✓ 

✓ 

✓ 

✓ 

1280x1024x8 


✓ 

✓ 

✓ 

1280x1024x16 



✓ 

✓ 

1280x1024x24 



✓ 

✓ 

1280x1024x32 




✓ 

1600x1200x4 

✓ 

✓ 

✓ 

✓ 

1600x1200x8 


✓ 

✓ 

✓ 

1600x1200x16 



✓ 

✓ 

1600x1200x24/32 




✓ 
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Section 2: Register Changes 


2.1 Vision968 REGISTER CHANGES 

Most Vision968 registers operate exactly as their Vision964 counterparts. The exceptions are shown 
in Table 2-1. New Vision968 registers are described in Sections 3.2 through 3.6. 

Table 2-1. Register Differences Between the Vision968 and Vision964 


Vision964 Register 

Bitls) 

Vision968 Description 

CR30 

7-0 

This is hardwired to E1H. Programmers must use CR2E to identify 
the chip. 

CR32 

3-2 

Reserved 

CR36 

3-2 

00 = One cycle EDO VRAM (new) 

01 = Reserved 

10 = EDO VRAM 

11 = Fast page mode VRAM 

CR40 

3 

0 = Normal SRDY operation 

1 = SRDY delayed by one cycle (VL-Bus only) 

CR50 

1 

0 = DACRD, DACWR active pulse = 2 SCLKs 

1 = DACRD, DACWR active pulse = 4 SCLKs 

CR50 

5-4 

00 = 4/8 bits/pixel 

01 = 16 bits/pixel 

10 = 24 bits/pixel (new) 

11 = 32 bits/pixel 

CR53 

0 

Reserved (write per bit no longer supported) 

CR53 


The power-on default depends on the system bus type. See the 
description for bits 4-3 below 

CR53 

2-1 

Big endian data byte swap (linear addressing and Video Engine 
transfers only) 

00 = No swap 

01 = Swap bytes within each word 

10 = Swap all bytes in doubleword (bytes reversed) 

11 = Reserved 
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Table 2-1. Register Differences Between the Vision964 and Vision968 (Continued) 


Vision964 Register 

Bit(s) 

Vision968 Description 

CR53 

4-3 

MMIO select 

00 = MMIO disabled 

01 = MMIO disabled 

10 = Vision964-type MMIO (AOOOOH window) 

11 = New MMIO (relocatable/packed) and Vision964-type MMIO 
VL-Bus power-on default = 00 

PCI bus power-on default = 11 

CR53 

7 

Enable upper byte write protection in 32 bits/pixel nnode 

0 = CAS3 and CAS7 enabled during 32 bits/pixel memory writes 

1 = CAS3 and CAS7 disabled during 32/bits/pixel memory writes 

CR54 

1-0 

Big endian data byte swap (not linear addressing off, not image 
writes and not Video Engine Access) 

00 = No swap 

01 = Swap bytes within each word 

10 = Swap all bytes in doubleword (bytes reversed) 

11 = Swap according to BE{3:0] (VL-Bus ) or C/BE(3:0] (PCI bus) 

BE13:0]/C/BE[3;0] 

0000 = Swap all bytes in doubleword (bytes reversed) 

0011 = Swap bytes within selected word 

1100 = Swap bytes within selected word 

All other values = No swap 

CR54 

2 

This is the high order extension bit (bit 5) for the M parameter (bits 7- 
3 of this register). This doubles the amount of memory bandwidth 
that can be allocated for Graphics Engine/CPU access. 

CR58 


The power-on default depends on the system bus type. See the 
description for bit 4 below. 

CR58 

4 

VL-Bus power-on default = 0 

PCI bus power-on default = 1 

CR59, CR5A 

15-0 

VL-Bus power-on default = OOOAH 

PCI bus power-on default = 7000H 

CR61 

6-5 

Big endian data byte swap (image writes) 

00 = No swap 

01 = Swap bytes within each word 

10 = Swap all bytes in doubleword (bytes reversed) 

11 = Reserved 

CR66 

3 

PCI disconnect enable (PCI bus only) 

0 = No effect 

1 = An attempt to write data with the Command FIFO full or to read 
data with the Command FIFO not empty generates a PCI bus 
disconnect cycle 



Bit 7 of CR66 must also be set to 1 for this feature to operate 
properly. Note that the previous function of this bit (set SCO to 

VCLK) is no longer available. 

I Enhanced Registers I 

82E8H 

11-0 

For polygons or trapezoids, this is the starting pixel vertical position 
for the first of two edges to be drawn. 
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Table 2-1. Register Differences Between the Vision964 and Vision968 (Continued) 


Vision964 Register 

Bit(s) 

Vision968 Description 

86E8H 

11-0 

For polygons or trapezoids, this is the starting pixel horizontal 
position for the first of two edges to be drawn. 

8AE8H 

11-0 

For polylines, this is the ending vertical position for each line 
segment. For polygons and 4-point trapezoids, this is the ending 
vertical position for the first of two edges to be drawn. For 

Bresenham parameter trapezoids, this is the axial step constant for 
the first of two edges to be drawn. 

8EE8H 

11-0 

For polylines, this is the ending horizontal position for each line 
segment. For polygons and 4-point trapezoids, this is the ending 
horizontal position for the first of two edges to be drawn. For 
Bresenham parameter trapezoids, this is the diagonal step constant 
for the first of two edges to be drawn. 

92E8H 

11-0 

For Bresenham parameter trapezoids, this is the error term for the 
first of two edges to be drawn. 

96E8H 

11-0 

For Bresenham parameter trapezoids, this is the major axis length 
for the first of two edges to be drawn. 

9AE8H 

10-9 

Select image write (E2E8H, E2EAH) bus transfer width 

00 = 8 bits 

01 = 16 bits 

10 = 32 bits. All doubleword bits beyond the image rectangle width 
are discarded. Each line starts with a fresh doubleword. The 
current drawing position ends up one pixel below the lower 
left hand corner of the image rectangle 

11 = 32 bits. This setting applies only to image transfers across the 
plane. Only padding bits up to the start of the next byte are 
discarded. The current drawing position ends up one pixel to the 
right of the top right corner of the rightmost image rectangle. 

9AE8H 

11, 

15-13 

Drawing Command 

0000 = NOP 

0001 = Draw line 

0010 = Rectangle fill 

0011= Polygon fill solid (new) 

0100 = 4-point trapezoid fill solid (new) 

0101 = Bresenham parameter trapezoid fill solid (new) 

0110 = BitBLT 

0111= Pattern BIT 

1001 = Polyline/2-point line (new) 

1011= Polygon fill pattern (new) 

1100 = 4-point trapezoid fill pattern (new) 

1101= Bresenham parameter trapezoid fill pattern (new) 

1110 = ROPBLT(new) 



See the Enhanced Mode Programming section for a description of 
each of these commands. 

AEE8H 

31-0 

Read mask for the ROPBLT pattern (same as previous Read Mask) 

BEE8H, Index E 

6 

Reserved 
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Table 2-1. Register Differences Between the Vision964 and Vision968 (Continued) 


Vision964 Register 

Bit(s) 

Vision968 Description 

BEE8H, Index E 

10 

0 = Allow 1 cycle EDO write operation 

1 = Disable 1 cycle EDO write operation 

PCI Registers I 

PCI Index 02H 

15-0 

The device ID is hardwired to 88F0H. 

PCI Index 04H 

7 

Hardwired to 1 to indicate that the device always does address/data 
stepping. 

PCI Index OAH 

7-0 

Now included In new Class Code register. 
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2.2 NEW Vision968 SR REGISTERS 

The SR registers described in this section have been added for the Vision968 and are not found in the 
Vision964. 


Extended Sequencer Register 9 (SR9) 

Read/Write Address: 3C5H, Index 09H 

Power-On Default: OOH 


7 

6 

5 

4 

3 

2 

1 

0 

MMIO- 

ONLY 

R 

R 

R 

R 

R 

R 

R 


Bits 6-0 Reserved 

Bit 7 MMIO-ONLY - Memory-mapped I/O register access only 

0 = If MMIO is enabled, both programmed I/O and memory-mapped I/O register 
accesses are allowed 

1 = If MMIO is enabled, only memory-mapped I/O register accesses are allowed 


External Bus Request Control Register (SRA) 

Read/Write Address: 3C5H, Index OAH 

Power-On Default: OOH 


7 

6 

5 

4 

3 

2 

1 

1 

0 

2 

MCLK 

R 

R 

R 

R 

R 

R 

R 


Bits 6-0 Reserved 

Bit 7 2MCLK - 2 MCLK CPU writes to memory (linear addressing) 
0 = 3 MCLK memory writes 
1 = 2 MCLK memory writes 
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2.3 NEW Vision968 CR REGISTERS 

The CR registers described in this section have been added for the Vision968 and are not found in the 
Vision964. 


Device ID High Register (CR2D) 

Read Only Address: 3?5H, Index 2DH 

Power-On Default: 88H 

This register should contain the same value as the upper byte of the PCI Vendor ID (Index OOH) register. 


7 

6 

5 

4 

3 

L.2 __ 

1 

0 

CHIP ID HIGH 


Bits 7-0 CHIP ID HIGH 


Device ID Low Register {CR2E) 

Read Only Address: 3?5H, Index 2EH 

Power-On Default: FOH 

This register allows software to identify whether a Vision968 is present. 


7 

6 

5 

4 

3 

2 

1 

0 

CHIP ID LOW 


Bits 7-0 CHIP ID LOW 

FOH for Vlsion968 


Revision Register (CR2F) 

Read Only Address: 3?5H, Index 2FH 

Power-On Default: OOH 


7 

6 

5 

— 

4 

3 

2 


0 

REVISION LEVEL 


Bits 7-0 REVISION LEVEL 
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2.4 NEW Vision968 ENHANCED COMMANDS REGISTERS 

The Enhanced Commands registers described in this section have been added for the Vision968 and 
are not found in the Vision964. 


Current Y-Position 2 Register {CUR_Y2) 

Read/Write Address: 82EAH 

Power-On Default: Undefined 

For polygons or trapezoids, this is the starting pixel vertical position for the second of two edges to be 
drawn. Reading this register produces the current vertical drawing coordinate for the second edge 
being drawn. 


15 

14 

13 

12 

11 

10 

9 

8 

7 

6 

5 

4 

3 

2 

1 

0 

R 

R 

R 

R 

CURRENT Y-POSITION 2 | 


Bits 11-0 CURRENT Y-POSITION 2 
Bits 15-12 Reserved 


Current X-Position 2 Register (CUR_X2) 

Read/Write Address: 86EAH 

Power-On Default: Undefined 

For polygons or trapezoids, this is the starting pixel horizontal position for the second of two edges to 
be drawn. Reading this register produces the current horizontal drawing coordinate for the second 
edge being drawn. 


15 

14 1 

13 

12 

11 

10 

1 aJ 

8 

7 

Ten 

5 

4 

3 

2 

1 

0 


R 

R 

R 

CURRENT X-POSITION 2 


Bits 11-0 CURRENT X-POSITION 2 
Bits 15-12 Reserved 
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Y-Coordinate 2/Axial Step Constant 2 Register (Y2_AXSTP2) 

Read/Write Address: 8AEAH 

Power-On Default: Undefined 

For polygons and 4-point trapezoids, this is the ending vertical position for the second of two edges 
to be drawn. For Bresenham parameter trapezoids, this is the axial step constant for the second of two 
edges to be drawn. 


15 

14 

13 

12 

11 

10 

9 

8 

7 

6 

5 

4 

3 

2 

1 

0 

R 

R 

R 

R 

Y-COORDINATE 2 


Bits 11-0 Y-COORDINATE 2 
Bits 15-12 Reserved 


15 

14 

13 

12 

11 

10 

9 

8 

7 

6 

5 

4 

3 

2 

1 

0 

R 

R 

LINE PARAMETER AXIAL STEP CONSTANT 2 


Axial Step Constant = 2 * (min(|dx|,|dy|)) In other words, when drawing a line from point A to point B, 
determine the change in the X coordinate from A to B and the change In the Y coordinate from A to B. 
Take the smaller of the two changes and multiply its absolute value by 2. 

Bits 13-0 LINE PARAMETER AXIAL STEP CONSTANT 2 

Bits 15-14 Reserved 


X-Coordinate 2 Register (X2) 

Read/Write Address: 8EEAH 

Power-On Default: Undefined 

For polygons and 4-point trapezoids, this is the ending horizontal position for the second of two edges 
to be drawn. For Bresenham parameter trapezoids, this is the diagonal step constant for the second of 
two edges to be drawn. 
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Bits 11-0 X-COORDINATE2 
Bits 15-12 Reserved 
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Line Error Term 2 Register (ERR_TERM2) 

Read/Write Address: 92EAH 

Power-On Default: Undefined 

For Bresenham parameter trapezoids, this is the error term for the second of two edges to be drawn. 
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Error Term = 2 * min{|dx|,|dy|) - max{|dx|,|dy| - 1 if the starting X < the ending X 
Error Term = 2 * min(jdxj,jdyj) - max(jdx|,jdyj if the starting X > the ending X 

See the Destination Y-Position/Axial Step Constant {8AE8H) register for an explanation of the terms 
used in these equations. 

Bits 13-0 ERROR TERM 2 

Bits 15-14 Reserved 


Major Axis Pixel Count 2 Register (MAJ_AXIS_PCNT2) 

Read/Write Address: 96EAH 

Power-On Default: Undefined 

This register specifies the length (in pixels) of the major (longest) axis for solid and textured lines and 
the width for rectangles, image transfers, BitBLTs and PatBLTs. For Bresenham parameter trapezoids, 
this is the major axis length for the first of two edges to be drawn. 
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RECTANGLE WIDTH 2/LINE PARAMETER M/\X 2 



Bits 11-0 RECTANGLE WIDTH 2/LINE PARAMETER MAX 2 

The value is the number of pixels along the major axis - 1. 

Bits 15-12 Reserved 
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Drawing Command 2 Register (CMD2) 

Write Only Address: 9AEAH 

Power-On Default: Undefined 


For Bresenhann parameter trapezoid fills, this register defines the drawing direction for the second 
edge to be drawn. The drawing direction for the first edge is specified in bits 7-5 of 9AE8H 
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Bits 4-0 Reserved 

Bits 7-5 DRWG-DIR 2 - Select Drawing Direction 2 

In the following table, the line is drawn from left to right or a +X and from right to left 
for a -X, down for a +Y and up for a -Y. X or Y maj specifies the longest axis. Axial 
drawing is specified in bits of 9AE8H. 


7-5 

x-y (Axial - bit 3 = 0} 

000 

-Y,X maj-X 

001 

-Y,X maj,-i-X 

010 

-Y,Y mai,-X 

oil 

-Y,Y maL-^X 

100 

+Y,X maj-X 

101 

+Y,X maj,+X 

110 

+Y,Y maj-X 

111 

+Y.Y ma\,+X 


Bits 15-8 Reserved 
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ROP Mix Selection Register (ROPMIX) 

Read/Write Address: D2E8H 

Power-On Default: Undefined 
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ROP MIX SELECTION 


Bits 7-0 ROP MIX SELECTION 

See Appendix A for a listing of the 256 mix selections available. 

Bit 8 MP - Mono pattern select 
0 = ROPBLT pattern is color 
1 = ROPBLT pattern is monochrome 

If a monochrome pattern is selected, the background and foreground colors are speci¬ 
fied In E6E8H and EEE8H respectively. 

Bits 15-9 Reserved 


ROPBLT Pattern Background Color Register (PAT_BG_COLOR) 

Read/Write Address: E6E8H 

Power-On Default: Undefined 

This register defines the background color for the ROPBLT pattern when bit 8 of D2E8H is set to 1 to 
specify a monochrome pattern. 
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Bits 31-0 BACKGROUND COLOR 

If bit 9 of BEE8_EH Is set to 1 or if MMIO is enabled, this becomes a 32-bit register. If 
bit 9 of BEE8_EH Is cleared to 0, this is two 16-bit registers. In 32 bpp mode with 16- 
bit registers, the upper and lower doublewords are read or written sequentially, de¬ 
pending on the state of the RSF flag (bit 4 of BEE8H, Index EH). If RSF = 0, the lower 
16 bits are accessed. If RSF = 1, the upper 16 bits are accessed. The RSF flag toggles 
automatically when a doubleword Is read or written. 
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Pattern Y (PAT_Y) 

Read/Write Address: EAE8H 

Power-On Default: Undefined 

This register defines the vertical coordinate top edge of an 8x8 pixel pattern programmed into 
off-screen memory. This is used with the Bresenham parameter trapezoidal fill pattern, trapezoidal 
4-pdint trapezoid fill pattern, polygon fill pattern and ROPBLT command types. 
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Bits 11-0 PATTERN Y 
Bits 15-12 Reserved 


Pattern X (PAT_X) 

Read/Write Address: EAEAH 

Power-On Default: Undefined 

This register defines the horizontal coordinate of the leftside of an 8x8 pixel pattern programmed into 
off-screen memory. This is used with the Bresenham parameter trapezoidal fill pattern, trapezoidal 
4-polnt trapezoid fill pattern, polygon fill pattern and ROPBLT command types. 
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Bits 11-0 PATTERN X 
Bits 15-12 Reserved 
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ROPBLT Pattern Foreground Color Register (PAT_FG_COLOR) 

ReadAVrite Address: EEE8H 

Power-On Default: Undefined 

This register defines the foreground color for the ROPBLT pattern when bit 8 of D2E8H is set to 1 to 
specify a monochrome pattern. 
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Bits 31-0 FOREGROUND COLOR 

If bit 9 of BEE8_EH is set to 1 or if MMIO is enabled, this becomes a 32-bit register. If 
bit 9 of BEE8_EH is cleared to 0, this is two 16-bit registers. In 32 bpp mode with 16- 
bit registers, the upper and lower doublewords are read or written sequentially, de¬ 
pending on the state of the RSF flag (bit 4 of BEE8H, Index EH). If RSF = 0, the lower 
16 bits are accessed. If RSF = 1, the upper 16 bits are accessed. The RSF flag toggles 
automatically when a doubleword is read or written. 
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2.5 NEW Vision968 PCI CONFIGURATION SPACE REGISTERS 

The PCI Configuration Space registers described in this section have been added for the Vision968 and 
are not found in the Vision964. 


Class Code 

Read Only Address: OSH 

Power-On Default: 30000H 

The class code is contained in bits 31-8. These 3 bytes are hardwired to 30000H to specify that the 
Vision968 is a VGA-compatible display controller. Bits 7-0 contain the Revision ID, and are present in 
the Vision964. 
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Interrupt Line 

Read/Write Address: 3CH 

Power-On Default: OOH 

This register contains interrupt line routing information written by the POST program during power-on 
initialization. 
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Bits 7-0 INTERRUPT LINE 


Interrupt Pin 

Read Only Address: 3DH 

Power-On Default: 01H 

This register is hardwired to a value of 1 to specify that INTA is the interrupt pin used. 
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Bits 7-0 INTERRUPT PIN 
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2.6 NEW Vision968 VIDEO ENGINE REGISTERS 

The Video Engine registers described in this section have been added for the Vision968. They are not 
found in the Vision964. 


Video Engine NOP Register 

Read/Write Address: 8080H 

Power-On Default: 0000 OOOOH 

Software must make a dummy write to this register when it is finished sending Video Engine 
commands. Graphics Engine commands can then follow. This NOP prevents simultaneous Video 
Engine and Graphics Engine operation. 
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Bits 31-0 NOP - No operation 


Video Engine Control Register 

Read/Write Address: 8088H 

Power-On Default: 0000 OOOOH 
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Bits 11-0 DDA ACCUMULATOR INITIAL VALUE 

Digital Differential Analyzer accumulator initial value = -MAX(Ws, Wd), where Ws is 
the width in pixels of the source and Wd is the width in pixels of the destination. 


Bits 15-12 Reserved 
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Bits 18-16 OUTPUT DATA FORMAT 

000 = 8 bits/pixel, RGB, 3.3.2 -can be translated with output table 
001 = Reserved 
010 = Reserved 

oil =32 bits/pixel, RGB, x.8.8.8 

100 = 16 bits/pixel, YCbCr, 4:2:2 

101 = 16 bits/pixel, raw 

110 = 15 bits/pixel RGB, 5.5.5 

111 = 16 bits/pixel RGB, 5.6.5 

Bit 19 CS - Color Space 

0 = YCbCr, 16-240 range 
1 = YUV 

Bits 22-20 INPUT DATA FORMAT 

000 = 8 bits/pixel, RGB, 3.3.2 -can be translated with output table 
001 = Reserved 
010 = Reserved 

011 = 32 bits/pixel, RGB, x.8.8.8 

100 = 16 bits/pixel, YCbCr, 4:2:2 

101 =16 bits/pixel, raw (scaling only) 

110 = 15 bits/pixel RGB, 5.5.5 

111 =16 bits/pixel RGB, 5.6.5 

Bits 25-23 DM INDEX - Dithering Matrix Index 

This is auto-incremented at the end of each line. It should be Initialized to 0 at the be¬ 
ginning of each new frame or block of lines. 

Bit 26 KM-Key Mask Enable 

0 = Disable - bypass function 
1 = Enable 

Bit 27 Reserved 

Bit 28 OTT - Output Table Translation Enable 
0 = Disable - bypass function 
1 = Enable 

Bit 29 DITH - Dithering 

0 = Disable - bypass function 
1 = Enable 

Bit 30 CSC - Color Space Converter 
0 = Disable - bypass function 
1 = Enable 

Bit 31 FILT-Filter 

0 = Disable - bypass function 
1 = Enable 
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Video Engine Stretch/Filter Constants Register 

Read/Write Address: 808CH 

Power-On Default: 0000 OOOOH 



Bits 10-0 K2 

If Ws>Wd, then K2 = Wd-Ws; If Ws<Wd, then K2 = Ws-Wd 

Ws is the width in pixels of the source and Wd Is the width in pixels of the destination. 

Bits 13-11 Reserved 

Bits 15-14 FILTER - Filter characteristics 
00 = Bl-llnear (default) 

01 = Linear, 0-2-4-2-0 

10 = Linear, 1-2-2-2-1 

11 = Reserved 

Bits 26-16 K1 

If Ws>Wd, then K1 = Wd; If WsWd, then K1 = Ws 

Ws is the width in pixels of the source and Wd is the width in pixels of the destination. 
Bits 28-27 Reserved 
Bit 29 SEN - Sense 

0 = Normal. Logic 1 in key mask enables video, logic 0 in key mask enables graphics 
1 = Reverse. Logic 0 In key mask enables video, logic 1 in key mask enables graphics 

Bit 30 HD - Host data 

0 = Data from screen 
1 = Data from host 

Bit 31 SS - Shrink/Stretch, Scale Down/Up 
0 = Stretch/Scale Up 
1 = Shrink/Scale Down 
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Video Engine Source/Destination Step Register 

Read/Write Address: 8090H 

Power-On Default: 0000 OOOOH 


15 

14 

13 

12 

— 

n 

— 

10 

9 

8 

— 

7 

6 

5 

4 

3 

2 

1 

0 

R 

R 

R 

DESTINATION STEP 


31 

30 

29 

28 

27 

26 

25 

24 

23 

22 

21 

20 

19 

18 

17 

16 

R 

R 

R i 

SOURCE STEP 


Bits 12-0 DESTINATION STEP 

This is the pitch that is added to the write address following a memory write cycle. 

For a horizontal stretch, this register should be programmed with an 8 for 2-MByte 
memory configurations or larger (8 bytes/write) or a 4 for 1-MByte memory configura¬ 
tions (4 bytes/write). For a vertical stretch, the step is the number of bytes/pixel times 
the number of pixels/line (bytes/line. 

Bits 15-13 Reserved 

Bits 28-16 SOURCE STEP 


This is the pitch that is added to the read address following a memory read cycle. 

For a horizontal stretch, this register should be programmed with an 8 for 2-MByte 
memory configurations or larger {8 bytes/write) or a 4 for 1-MByte memory configura¬ 
tions (4 bytes/write). For a vertical stretch, the step is the number of bytes/pixel times 
the number of pixels/line (bytes/line). 

Bits 31-29 Reserved 
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Video Engine Crop Register 

ReadAVrite Address: 8094H 

Power-On Default: 0000 OOOOH 
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Bits 11-0 LENGTH 

Value = Actual number of pixels to process 
Bits 15-13 Reserved 
Bits 27-16 START 


Value = Number of pixels to not be written after starting 
Bits 15-13 Reserved 


Video Engine Source Base Address Register 

ReadAA/rite Address: 8098H 

Power-On Default: 0000 OOOOH 
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Bits 23-0 SOURCE BASE ADDRESS 

Source base address (in bytes) in display memory for the image to be processed by 
the Video Engine. The source address is in display memory only for the second pass 
of a 2-pass operation. Otherwise, the source is system memory with the data pro¬ 
vided by the Host. In this case, only bits 1-0 of this register are relevant. The decimal 
value of bits 1-0 is the number of bytes to discard from the start of each pixel line 
stream from the Host. This allows adjustment for non-doubleword-aligned pixel data 
in system memory. 


REGISTER CHANGES 2-19 






S3 Vision968 Multimedia Accelerator 


S3 Incorporated 


Bits 31-24 Reserved 


Video Engine Destination Base Address Register 

Read/Write Address: 809CH 

Power-On Default: 0000 OOOOH 
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DESTINATION BASE ADDRESS [23:16] 


Bits 23-0 DESTINATION BASE ADDRESS [23:0] 

Destination base address (in bytes) in display memory for the image to be processed 
by the Video Engine. 

Bits 30-24 Reserved 

Bit 31 VEB - Video Engine busy (Read Only) 

0 = Video Engine not busy 
1 = Video Engine busy 


2.7 Vision964 REGISTERS REMOVED FROM THE Vision968 

All backward compatibility registers found in the Vision964 are removed from the Vision968. These 
include all registers described in Sections 12 and 13 of the Vis}on964 Graphics Accelerator Data Book. 


2-20 REGISTER CHANGES 







S3 Vision968 Multimedia Accelerator 


S3 Incorporated 


Section 3: Functional Changes 


This section describes a number of enhance¬ 
ments provided by the Vision968 as compared 
with the Vision964. The new features related to 
Enhanced mode programming support are de¬ 
scribed in Section 4. The new Video Engine capa¬ 
bility for the Vision968 is described in Section 5. 

3.1 CHIP IDENTIFICATION 

Three new chip identification registers are pro¬ 
vided. CR2D is hardwired with 88H. This is the 
upper word of the device I.D.. CR2E is hardwired 
with BOH for the Vision968. This is the low byte 
of the device I.D.. CR2F contains the revision 
level. CR30, the old I.D. register, contains E1H. 

3.2 SHARED FRAME BUFFER 
MEMORY BANDWIDTH 
ALLOCATION 

The Vision968 provide the same bus request/bus 
grant shared frame buffer capability as the 
Vision964. 

For the Vision968, the M parameter field is 6 bits 
instead of 5 bitsforthe Vision964.The M parame¬ 
ter is used only for VGA modes. 

3.3 PCI ENHANCEMENTS 

The Vislon968 contain several enhancements for 
PCI bus operation. 


3.3.1 Interrupt Support 

PCI configuration space registers Index 3CH (In¬ 
terrupt Line) and Index 3DH (Interrupt Pin) are 
added to support handling of interrupts. 


When in PCI mode, the INTA pin floats. Interrupt 
generation drives it active low. When the inter¬ 
rupt is removed, the INTA pin again floats. 

When in VL-Bus mode, the SINTR pin is driven 
high. Interrupt generation drives It low and then 
releases it to be driven high again (edge trig¬ 
gered). 

3.3.2 RAMDAC Snooping 

For PCI bus configurations, setting bit 5 of the 
Command configuration space register (Index 
04H) to 1 causes the Vislon968 to snoop for 
RAMDAC writes. This means that the Vlsion968 
will write the data to the local RA MDAC bu t will 
not claim the cycle by asserting DEVSEL. This 
allows the ISA controller to also generate a write 
cycle to a secondary RAMDAC. The Vislon968 
always provide the data for RAMDAC reads. 

If snooping Is enabled, the 3C8 and 3C9 DAC 
registers cannot be written with a single word 
write. They must be written separately with byte 
writes. 

If bit 5 of the PCI Command register is cleared to 
0, the Vlslon968 claims all RAMDAC read and 
write cycles. 
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3.3.3 Disconnect Related to FIFO 
Status 

If bits 3 and 7 of CR66 are set to 1, pixel data writes 
made with the command FIFO full or memory 
reads made with the Command FIFO not empty 
will generate a PCI disconnect. 

3.3.4 Plug and Play Support 

When the Vision968 powers up in PCI mode, it 
defaults to linear addressing and memory- 
mapped I/O enabled at a relocatable base ad¬ 
dress of 7000 OOOOH. This allows the PCI system 
to reconfigure as required for plug and play. 

3.4 PACKED 24-BITS/PIXEL 
SUPPORT 

In 32 bits/pixel modes, the Graphics Engine can 
process two pixels simultaneously (64 bits). The 
Vislon968 also provides accelerated packed 24 
bits/pixel operation. This means that 2 2/3 pixels 
can be processed simultaneously, resulting in an 
approximately 25% performance Improvement. 
Packed 24 bits/pixel operation Is selected by set¬ 
ting bits 5-4 of CR50 to 10b. 

Most of the hardware acceleration features avail¬ 
able for 32 bits/pixel operation are also available 
for packed 24 bits/pixel operation. Those func¬ 
tions for which hardware acceleration is not pro¬ 
vided for packed 24 bits/pixel operation are: 

• Textured line draw 

• BitBLT across the plane 

• Color comparison 

• Video Engine operation 

Image transfers (CPU as data source) can be 
performed in packed 24 bits/pixel mode. 

When using packed 24 bits/pixel operation, all 
drawing coordinates (e.g., current X,Y or destina¬ 
tion X,Y) must be positive numbers. 


3.5 RAMDAC ACCESS CYCLES 


The RAMDAC strobes DACRD and DACWR are 
based on MCLKfor the Vlslon964. They are based 
on SCLKforthe Vision968. The PCI bus RAMDAC 
access functional timing for the Vision968 Is 
shown In Figures 3-1 and 3-2. VL-Bus cycles have 
the same timing characteristics. 


The active pulse of DACRD or DACWR is 2 SCLKs 
if bit 1 of CR50 is cleared to 0 and 4 SCLKs if this 
bit is set to 1. The latter setting is required for 50 
MHz VL-Bus operation to ensure a pulse width 
greater than 50 ns. Selecting a 4 SCLK active 
pulse width extends the total cycle by 10 SCLKs. 

3.6 50 MHz VL-BUS SUPPORT 

Setting bit 3 of CR40 to 1 adds a wait state to 
VL-Bus cycles by delaying SRDY by one clock. 
This is required for 50 MHz VL-Bus operation. In 
addition, bit 1 of CR50 must be set to 1 to extend 
the RAMDAC read and write strobe pulses. 

3.7 WRITE PER BIT SUPPORT 

The Vision968 does not support write per bit and 
bit 0 of CR53 is now reserved. 
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3.8 READ/MODIFY/WRITE TIMING 

The read/modify/write cycles for fast page and 
EDO memories have been modified from the 
Vision964. These are shown in Figures 3-3 and 
3-4. 


For fast page mode ope ration , read data is 
latched by the rising edge of CAS. For 2 cycle EDO 
operation, the read data i s latc hed by the rising 
edge of MCLK following a CAS rising edge. 

Note that both Figure 3-3 and 3-4 are based on a 
RAS precharge of 2.5 MCLKs. 


T9 T10 


Figure 3-3. Fast Page Mode Read/Modify Write Timing 

Ti T2 T3 T4 T5 T6 T7 T8 T9 T10 


Figure 3-4. EDO Mode Read/Modify Write Timing 
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3.9 1 CYCLE EDO VRAM SUPPORT 

Bits 3-2 of CR36 are cleared to 00b to indicate that 
1 cy cle EDO VRA M operation is being used. Note 
that CAS/OE/WE stretch capability provided by 
bits 1-0 of CR68 is unavailable with 1 cycle EDO 
operation. This mode of operation uses standard 
EDO VRAMs with more aggressive timing. 

The functional timing for 1 cycle EDO reads and 
writes is provided by Figure 3-5. The VRAM 
drives valid read data after the first CAS falling 
edge. The chip latches the data on the second 


falling CAS edge. This means that a dummy cycle 
is required at the end to latch the last read. Write 
da ta is latched by the VRAM on the falling edge 
of CAS. No dummy cycle is required. 

Figure 3-6 shows a read/modify/write cycle with 
1 cycle EDO operation. A dummy cycle is added 
between the read and write. 

All line draws, image transfers, linear addressing 
and pixel formatter operation are not supported 
with 1 cycle EDO. 2 cycle EDO operation will 
automatically be used with these functions. 
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Section 4: Electrical Data 


4.1 MAXIMUM RATINGS 

Table 4-1. Absolute Maximum Ratings 


Ambient temperature 

0“ C to 70° C 

Storage temperature 

-40°Cto 125°C 

DC Supply Voltage 

-0.5V to 7.0V 

I/O Pin Voltage with respect to Vss 

-0.5V to Vdd+0.5V 


4.2 DC SPECIFICATIONS 


Table 4-2. DC Specifications (VDD = 5V ± 5%, Operating Temperature 0° C to 70° C) 


Symbol 

Parameter 

Min 

Max 

Unit 

ViL 

Input Low Voltage 


0.8 

V 

VlH 

Input High Voltage 

2.0 (Note 1) 


V 

VoL 

Output Low Voltage 


Vss + 0.4 

V 

VOH 

Output High Voltage 

2.4 


V 

lOLI 

Output Low Current 

4 (Note 2) 


mA 

lOHI 

Output High Current 

-2 


mA 

IOL2 

Output Low Current 

8 (Note 3) 


mA 

l0H2 

Output High Current 

-4 


mA 

l0L3 

Output Low Current 

16 (Note 4) 


mA 

l0H3 

Output High Current 

-8 


mA 

l0L4 

Output Low Current 

24 (Note 5) 


mA 

l0H4 

Output High Current 

-10 


mA 

l0L5 

Output Low Current (TTL) 

9 (Note 6) 


mA 

l0H5 

Output High Current (TTL) 

-9 


mA 

loz 

Output Tri-state Current 


1 


ClN 

Input Capacitance 


5 

PF 

COUT 

Output Capacitance 


5 

PF 

Icc 

Power Supply Current 


425 

mA 
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Notes for Table 4-2 

1. 2.4 V max for SCLKI 

2. loLi, loHi for pins BLANK, CAS[7:0], DACRD, DACWR, GD[7:0], HSYNC, INTA (SINTR) 
MA[8:0], MB[8:0], PAI7:0], PD[63:0], RS[3:0], RMSTRD, STWR, VSYNC, BGNT 

3. loL2/ loH2 for pin VCLK 

4. loL3, loH3 for pins OE[1:0], RAS[1:0] 

5. l0L4, l0H4 for pins PAR (AMN), STOP (DBEN), DEVSEL (LO^), TrDY (SR^), WE[1:0] 

6. loL5/ loH5 for pins AD[31:0], DBDIR 

Note 

Pin names for VL-Bus configurations are shown in parentheses. 

4.3 AC SPECIFICATIONS 

Notes: 

1. All AC timings are based on an 80 pF test load. 

2. Functional timing diagrams are found in the appropriate functional descriptions section, i.e.. 
System Bus Interfaces, Display Memory or Miscellaneous Functions in the Vlsion964 data 
book or Functional Changes in this data booklet. 
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4.3.1 Clock Timing 



Table 4-3. Clock Waveform Timing 


Symbol 

Parameter 

Min 

Max 

Units 

Notes 

Tcyc 

SCLK Cycle Time (VL-Bus) 

20 

125 

ns 

1 


SCLK Cycle Time (PCI) 

30 

125 

ns 

1 


MCLK Cycle Time 

16.7 

25 

ns 

3 


MCLK Cycle Time 

20 

25 

ns 

4 


DCLK Cycle Time (VGA Mode) 

25 

100 

ns 

1 


DCLK Cycle Time (Enhanced Mode) 

10 

100 

ns 

1 

Thigh 

SCLK High Time (VL-Bus) 

8 

80 

ns 



SCLK High Time (PCI) 

12 

80 

ns 



MCLK High Time 

6 

10 

ns 

3 


MCLK High Time 

8 

12 

ns 

4 


DCLK High Time (VGA Mode) 

10 

65 

ns 



DCLK High Time (Enhanced Mode) 

4 

65 

ns 


Tlow 

SCLK Low Time (VL-Bus) 

8 

80 

ns 



SCLK Low Time (PCI) 

12 

80 

ns 



MCLK Low Time 

6 

10 

ns 

3 


MCLK Low Time 

8 

12 

ns 

4 


DCLK Low Time (VGA Mode) 

10 

65 

ns 



DCLK Low Time (Enhanced Mode) 

4 

65 

ns 



SCLK, MCLK, DCLK Slew Rate 

1 

4 

V/ns 

2 


Notes: 

1 . focLK ^ 1/2 fscLK to ensure valid writes to the clock chip. 

2. Rise and fall times are specified in terms of the edge rate measured in V/ns. This slew rate 
must be met across the minimum peak-to peak portion of the clock waveform. 

3. For fast page and standard EDO VRAM 

4. For single cycle EDO VRAM 
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4.3.2 Input/Output Timing 


SCLK 

MCLK 

DCLK 


INPUT 



Figure 4-2. Input Timing 


Table 4-4. SCLK-Referenced Input Timing 


PCI Bus 




Symbol 

Parameter 

Min 

Units 

Tsu 

AD[31:0L C/BE[3:0], FRAME, IRDY, IDSEL setup 

7 

ns 

Th 

AD[31:0] hold 

1 

ns 

Th 

C/BE13;0], FRAME, IRDY, IDSEL hold 

0 

ns 

VL-Bus 1 

Symbol 

Parameter 

Min 

Units 

Tsu 

AD[31 ;2], BE[3;01, SM/IO, SW/R, SADS (address 
phase) setup 

12 

ns 

Th 

ADI31:2], BE[3:0], SM/IO, SW/R. SADS (address 
phase) hold 

0 

ns 

Tsu 

AD[31:2], BE[3:01, Dl, DO, SADS (data phase) 
setup 

4 

ns 

Th 

AD[31:21, BE[3:01, Dl, DO, SADS (data phase) hold 

0 

ns 

Tsu 

RDYIN setup 

6 

ns 

Th 

RDYIN hold 

1 

ns 

Miscellaneous | 

Symbol 

Parameter 

Min 

Units 

Tsu 

ROM Data GD17:0) Setup (PCI) 

5 

ns 

Th 

ROM Data GD[7:0] Hold (PCI) 

7 

ns 

Tsu 

General Input Port GD[7:0] setup 

5 

ns 

Th 

General Input Port GDI7:01 hold 

7 

ns 
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SCLK 

MCLK 

DCLK 




N- DELAY -M 


OUTPUT 



1.5 V 


Figure 4-3. Output Timing 


Table 4-5. SCLK-Referenced Output Timing 


PCI Bus 1 

Parameter 

Tmin 

Tmax 

Units 

Notes 

AD[31:0] valid delay 

2 

16 

ns 

1 

DEVSEL, PAR delay 

2 

11 

ns 

Medium DEVSEL 
timing used 

STOP delay 

2 

11 

ns 


TRDY delay 

2 

11 

ns 


INTA delay 

2 

11 

ns 


VL-Bus 1 

Parameter 

Tmin 

Tmax 

Units 

Notes 

AD[31:2], D1, DO valid delay 

7 

16 

ns 


SINTR delay 

5 

30 

ns 


SRDY delay 

5 

11 

ns 


LOCA active delay 

5 

15 

ns 


LOCA inactive delay 

5 

20 

ns 


DBDIR delay 

5 

16 

ns 


ABEN, DBEN active delay (min non-overlap) 

5 

12 

ns 


ABEN, DBEN active delay (max non-overlap) 

5 

15 

ns 


ABEN, DBEN inactive delay 

5 

13 

ns 


Miscellaneous I 

Parameter 

Tmin 

Tmax 

Units 

Notes 

RS[3:0] delay 

5 

25 

ns 


RMSTRD delay 

3 

15 

ns 


ROM Address valid delay (PCI) 

5 

30 

ns 


AD[7:0] ROM Data valid delay (PCI) 

5 

30 

ns 


DACRD, DACWR delay 

3 

20 

ns 



Note 


1. Due to the timing for TRDY for read cycles, data is not sampled on the clock edge immediately 
following its becoming valid. This guarantees the PCI 2.0 specification time of 11 ns. 
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Table 4-6. MCLK-Referenced Input Timing 


Symbol 

Parameter 

Min 

Units 

Tsu 

PD[63:0] setup (EDO memory) 

0 

ns 

Th 

PD[63:0] hold (EDO memory) 

10 

ns 

Tsu 

General Input Port GD[7:01 setup 

5 

ns 

Th 

General Input Port GD[7:0] hold 

7 

ns 


Table 4-7. MCLK-Referenced Output Timing 


Parameter 

Tmin 

Tmax 

Units 

RAS[1:0] active delay 

5 

15 

ns 

RAS[1:0] inactive delay 

5 

14 

ns 

CAS[7:0]. OE[1:0]. WE[1 ;0] active delay 

7 

15 

ns 

CAS[7:0], OE[1:0], WE[1:0] inactive delay (min stretch) for 
fast page and standard EDO VRAM 

6 

8 

ns 

CAS[7:0], OE[1:0], WE[1:0] inactive delay (max stretch) for 
fast page and standard EDO VRAM 

6 

17 

ns 

CAS[7:0] active delay with respect to falling edge of 

MCLK for 1 cycle EDO operation 

6 

15 

ns 

MA[8:0], MB[8:0] valid delay 

5 

24 

ns 

PD[63:0] valid delay 

5 

27 

ns 


Table 4-8. DCLK-Referenced Output Timing 


Parameter 

Tmin 

Tmax 

Units 

BLANK, HSYNC, VSYNC delay 

3 

17 

ns 

VCLK delay 

7 

14 

ns 

PA[7:0] valid delay 

5 

14 

ns 

STWR delay 

3 

20 

ns 

General Output Port Data GD[7:0] delay 

5 

25 

ns 

SC[1:0] delay 

8 

17 

ns 

SE[3:0] delay 

7 

14 

ns 

DSF delay 

8 

17 

ns 


Table 4-9. Fast Page Mode Memory Input Timing 


Symbol 

Parameter 

Min 

Units 

Tsu 

PD[63:0] setup to CAS[7:0] inactive 

0 

ns 

Th 

PD[63:0] hold from CAS17:01 Inactive 

5 

ns 
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Table 4-10. 1 Cycle EDO Mode Memory Input Timing 


Symbol 

Parameter 

Min 

Units 

Tsu 

PD[63;0] setup to CAS[7:0] active 

0 

ns 

Th 

PD[63:0] hold from CAS[7;0] active 

5 

ns 



Figure 4-4. Reset Timing 


Table 4-11. Reset Timing 


Symbol 

Parameter 

Min 

Units 

Tlow 

SRESET (VL) or RESET (PCI) active pulse width 

400 

ns 

Tsu 

PD[23:0] setup to SRESET (VL) or RESET (PCI) 
inactive 

20 

ns 

Th 

PD[23:0] hold from SRESET (VL) or RESET (PCI) 
inactive 

10 

ns 


4.4 OUTPUT BUFFER MODEL 

Figure 4-5 shows a first order output buffer model for the Vision968. The parameters are: 


Parameter 

Description 

dV/dt 

Mininum and maximum rate of change of the open circuit voltage source used in the 
buffer model 

Ro 

Minimum and maximum output impedance of the buffer model 

Co 

Minimum and maximum capacitance used in the buffer model 

Lp 

Minimum and maximum package inductance 

Cp 

Minimum and maximum package capacitance 


The parameter values appropriate for the Vision968 depend on the manufacturing process and can be 
obtained directly from S3. 
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Section 5: Enhanced Mode Programming 


Enhanced nnode provides a level of performance far beyond what is possible with the VGA architecture. 
Hardware line drawing, BitBLT, rectangle fill and other drawing functions are implemented. Also 
implemented are data manipulation functions, such as data extension, data source selection, and 
read/write bitplane control. Hardware clipping is supported by 4 registers that define a rectangular 
clipping area. While in Enhanced mode, the display memory bit map can be updated in two ways. One 
is to have the CPU write directly to memory. (This is also possible In non-Enhanced modes via paging.) 
The other is to have the CPU issue commands to the Graphics Engine, which then controls pixel 
updating. This section explains these two methods and provides a comprehensive set of Enhanced 
mode programming examples. 

5.1 MEMORY-MAPPED I/O 

The Vislon968 provide two memory-mapped I/O (MMIO) schemes. One method is identical to that 
provided by the Vision864 and provides compatibility with older software. This provides memory 
mapping of a limited number of Enhanced mode registers. The second method is new to the Vision968. 
It Incorporates linear addressing and provides memory mapping of all registers. In addition, the 
Enhanced mode registers can be accessed by a packed method that Improves performance by allowing 
two 16-blt registers to be accessed by a single 32-bit write cycle. More registers can be accessed via 
the packed method than by the standard method. Each of these MMIO methods is described below. 

5.1.1 Backward-Compatible MMIO 

Most of the Enhanced registers can be memory-mapped. This function is enabled by setting bits 4-3 
of CR53 to 10b. When bit 3 of CR53 is cleared to 0, the old MMIO can also be enabled by setting bit 5 
of4AE8Hto 1. 

Image writes normally made via I/O addresses E2E8H and E2EAH (the Pixel Data Transfer registers) 
are made Instead by accessing any memory location in the 32-KByte address space from AOOOOH to 
A7FFFH. This allows efficient use of the MOVSW and MOVSD assembly language commands. Accesses 
must be to even word or doubleword addresses, depending on the specification of the bus width via 
bits 10-9 of 98E8H. Software must not make E2E8H, E2EAH writes beyond the A7FFFH range. 

Accesses to the Enhanced command registers are made to particular locations in the A8000H to AFFFFH 
address range as shown in Table 5-1. Both 16-bit reads and writes are supported. Only 32-bit writes 
(bit 9 of BEE8H_E set to 1) are supported. 
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Table 5-1. Enhanced Registers Memory Mapping 


Register Mnemonic 

I/O Address (Hex) 

Old MMIO = Axxxx 

Register 

Mnemonic 

(Packed) 

Packed MMIO 
Offset (Hex) 

(100 xxxx) 

CUR_Y, CUR_X 

82E8, 86E8 

ALT_CURXY 

8100, 8102 

CUR_Y2, CUR_X2 

82EA, 86EA 

ALT_CURXY2 

8104, 8106 

DESTY_AXSTP, DESTX.DIASTP 

8AE8, 8EE8 

ALT_STEP 

8108, 81OA 

Y2_AXSTP2, X2_DIASTP2 

8AEA, 8EEA 

ALT_STEP2 

81OC, 81OE 

ERR_TERM, ERR_TERM2 

92E8, 92EA 

ALT.ERR 

8110, 8112 

CMD, CMD2 

9AE8. 9AEA 

ALT.CMD 

8118, 811A 

SHORT_STROKE 

9EE8 


811C 

BKGD.COLOR 

A2E8 


8120 

FRGD_COLOR 

A6E8 


8124 

WRT_MASK 

AAE8 


8128 

RD.MASK 

AEE8 


812C 

COLOR_CMP 

B2E8 


8130 

BKGD_M1X, FRGD_MIX 

B6E8, BAE8 

ALT_MIX 

8134, 8136 

SCISSORS_T, SCISSORS_R 

BEE8_1, BEE8_2 


8138, 813A 

SCISSORS.B, SCISSORS_R 

BEE8_3, BEE8_4 


813C, 813E 

PIX_CNTL, MULT_MISC2 

BEE8_A, BEE8_D 


8140, 8142 

MULT_M1SC, READ_SEL 

BEE8_E, BEE8_F 


8144, 8146 

M1N_AXIS_PCNT, MAJ_AXIS_PCNT 

BEE8_0, 96E8 

ALT_PCNT 

8148, 814A 

MAJ_AXIS_PCNT2 

96EA 


814C 

ROPMIX 

D2E8 


8150 

DESTX_DIASTP, MAJ_/\XIS_PCNT 

8EE8, 96E8 

MAXX 

8154, 8156 

PlX.TRANS 

E2E8, E2EA 

PIX-TRANS 

0000 

pat_bg_color 

E6E8 


8164 

PAT_Y, PAT_X 

EAE8, EAEA 

ALT.PAT 

8168, 816A 

PAT_FG_COLOR 

EEE8 


816C 


5.1.2 NewMMIO 

The new MMIO method for the Vision968 provides a 64-MByte addressing window starting at the base 
address specified in CR59-5A. This space is divided into a 32-MByte space for little endian (Intel-style) 
addressing and a 32-MByte space for big endian (Power PC-style) addressing. All registers and data 
transfer locations are mapped into this area as shown in Table 5-2. 

The new MMIO is enabled by setting bits 4-3 of CR53 to 11b. This is the default for a PCI bus 
configuration, allowing PCI software immediate access to ail registers and the ability to relocate the 
address space. VL-Bus configurations power up with bits 4-3 of CR53 cleared to 00b, disabling both 
old and new MMIO operation. 

If either the old or new MMIO is enabled, bit 7 of SR9 allows register access to be either programmed 
I/O (IN, OUT) or MMIO (MOV) or MMIO only. 


5-2 ENHANCED MODE PROGRAMMING 






S3 Vision968 Multimedia Accelerator 



S3 Incorporated 


Table 5-2. New MMIO Addresses 


Description 

Memory Map Offset 

Low 32 MBytes: Little Endian 

A[25:0] Hex 

Linear Addressing (16IV1) 

000 0000:0FF FFFF 

Image Transfer Data (via E2E8, E2EA) (32K) 

100 0000:100 7FFF 

PCI Configuration Space 

100 8000:100 803F 

Packed Enhanced Registers 

100 8100:100 816F 

Current Y-Position Register 

100 82E8 

Current Y-Position 2 Register 

100 82EA 

VGA 3B? Registers 

100 83B0:100 83BX 

VGA 3C? Registers 

100 83C0:100 83CX 

VGA 3D? Registers 

100 8300:100 83DX 

Setup Option Select Register (102H) 

100 8502 

Subsystem Status Enhanced Register (42E8H) 

100 8504 

Video Subsystem Enable Register (46E8H) 

100 8508 

Advanced Function Control Register (4AE8H) 

100 850C 

Enhanced Mode Registers 

100 86E8:100 EEEA 

Pixel Formatter Data Transfer 

101 0000:101 3FFF 

Pixel Formatter Mask Data 

101 4000:101 7FFF 

Pixel Formatter Registers 

101 8080:101 809F 

High 32 MBytes: Big Endian 

A[25:0] Hex 

Linear Addressing (16M) 

200 0000:2FF FFFF 

Image Transfer Data (via E2E8, E2EA) (32K) 

300 0000:300 7FFF 

PCI Configuration Space 

300 8000:300 803F 

Packed Enhanced Registers 

300 8100:300 816F 

Current Y-Position Register 

300 82E8 

Current Y-Position 2 Register 

300 82EA 

VGA 3B? Registers 

300 8380:300 83BX 

VGA 3C? Registers 

300 83C0:300 83CX 

VGA 3D? Registers 

300 83D0:300 83DX 

Setup Option Select Register (102H) 

300 8502 

Subsystem Status Enhanced Register (42E8H) 

300 8504 

Video Subsystem Enable Register (46E8H) 

300 8508 

Advanced Function Control Register (4AE8H) 

300 850C 

Enhanced Mode Registers 

300 86E8:300 EEEA 

Pixel Formatter Data Transfer 

301 0000:301 3FFF 

Pixel Formatter Mask Data 

301 4000:301 7FFF 

Pixel Formatter Registers 

301 8080:301 809F 


The base address is taken from bits 31-26 of the linear address window position (bits 7-2 of CR59 or 
the high order 6 bits of the the PCI Base Address 0). This is concatenated with the address offset 
specified by the programmer per Table 5-2. The base address bits must not be all O's, as this may cause 
operating system address spaces to be overwritten. 
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When the new MMIO is enabled, both 16-bit MMIO reads and writes are supported. Only 32-blt writes 
are supported. 

5.1.2.1 Big/Little Endian Support 

The Vision968 provide support for both big and little endian addressing. In addition to using the new 
MMIO addressing as shown in Table 5-2, the required byte swapping must be specified as shown in 
Table 5-3. 

Table 5-3. Big Endian Byte Swap Select 


Byte Swapping Affects: 

Swapping Specified by: 

Linear Addressing, Video Engine (read/write) 

CR53, bits 2-1 

Image Data (writes to Graphics Engine) 

CR61, bits 6-5 

All other registers/data areas (read/write) 

CR54, bits 1-0 


5.1.2.2 Packed MMIO Register Mapping 

For improved performance, most of the Enhanced mode registers can also be accessed via a packed 
configuration. The 16-bit registers are paired so that two registers can be accessed via a single 32-bit 
write. Reads must be 16-bit. The address offsets from the base address for this packed configuration 
are given in Table 5-1. The packed register access function is enabled when the new MMIO is enabled 
(bit 3 of CR53 set to 1). 

5.2 DIRECT BITMAP ACCESSING—LINEAR ADDRESSING 

Linear addressing is useful when software requires direct access to display memory. The Vision968 
provides two linear addressing schemes. One is the same as provided for the Vision964 and thus 
provides compatibility with older software. The second Is integrated into the new memory-mapped 
I/O method and thus requires updated drivers for use. 

5.2.1 Backward-Compatible Linear Addressing 

Enhanced mode operation must be enabled before linear addressing Is enabled. This means that bit 
0 of 4AE8H is set to 1 to enable Enhanced mode functions and bit 3 of CR31 is set to 1 to specify 
Enhanced mode memory mapping. 

The Vision968 provides linear addressing of up to 8 MBytes of display memory. Linear addressing of 
more than 64 KBytes requires that Intel-style CPUs be operated in 386 protected mode. 

The Graphics Engine busy flag, bit 9 of 9AE8H, should be verified to be 0 (not busy) before linear 
addressing is enabled. This is done by setting bit 4 of CR58 or bit4 of 4AE8H to 1. The size of the linear 
address window is set via bits 1-0 of CR58. The base address for the linear addressing window is set 
via CR59 and CR5A (or via the Base Address 0 (Index 10H) PCI configuration register for PCI systems). 

The linear addressing window size can be set to 64 KBytes. The base address for the window is set by 
programming bits 31-16 of the window position in CR59-CR5A. This allows the CPU to be operated in 
real mode. If bit 0 of CR31 is set to 1, the memory page offset (64K bank) specified in bits 5-0 of CR6A 
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is added to the linear addressing window position base address, allowing access to up to 8 MBytes of 
display memory through a 64-KByte window. 

5.2.2 New Linear Addressing 

The first 16 MBytes of each 32M address space (big and little endian) are dedicated to linear addressing. 
A maximum of 8 MBytes of each address space (starting at the lowest address of the space) is usable 
with the Vlslon968. When the new MMIO is enabled (bits 4-3 of CR53 set to 11 b), the base address is 
taken from bits 31-26 of the linear address window position (bits 7-2 of CR59 or the high order 6 bits 
of the the PCI Base Address 0). This is concatenated with the display memory address specified by the 
programmer. 

In addition to enabling the new MMIO, the programmer must also enable linear addressing and specify 
the window size exactly as required for the old linear addressing. Note that since only bits 31-26 are 
used to specify the base address, AOOOOH cannot be specified and the 64K banking scheme possible 
with the old linear addressing cannot be used with the new linear addressing. 

When big endian addressing is used, the required byte swapping for linear addressing is specified by 
bits 2-1 of CR53. This applies to both reads and writes. 

5.3 BITMAP ACCESS THROUGH THE GRAPHICS ENGINE 

When updating the display bitmap through the Graphics Engine, all CPU data moves through the Pixel 
Data Transfer registers (E2E8H and E2EAH). These can be memory mapped as explained In Memory 
Mapping of Enhanced Mode Registers later In this section. 

The Graphics Engine manipulates the bits for each pixel to assign a color value, which is then translated 
by the RAMDAC into the color displayed on the CRT. Selected bits In a pixel can be masked off from 
being displayed by programming the DAC Mask register (3C6H). The Vision968 can manipulate 64 bits 
each clock cycle, from two 32-blt pixels to eight 8-bit pixels. 

Figure 5-1 is a flowchart for the process of updating the color of each pixel in the display bitmap. Start 
at the block labeled 'New Color' In the middle of Figure 5-1. At this stage, a color has been determined 
that may or may not be used to update a pixel in the bitmap. How this color is determined will be 
covered later. 

The first hurdle for the new color Is the color compare process. If this is turned off (bit 8 of BEE8H, 
Index OEH = 0), the new color is passed to the Write Mask register (AAE8H). If the plane to which the 
pixel update is directed has been masked off In this register, no update occurs. Otherwise, the new 
color value is written to the bitmap. 

If color compare is enabled (bit 8 of BEE8H, Index OEH = 1), the new color value (source) is compared 
to a color value programmed into the Color Compare (B2E8H) register. The sense of the color 
comparison is determined by the SRC NE (source not equal) bit (bit 7) of BEE8H, Index OEH. If this bit 
is 0, the new pixel color value Is passed to the write mask only when the source color does not match 
the color in the Color Compare register. If this bit is 1, the new pixel color value is passed to the write 
mask only when the source color matches the color in the Color Compare register. If the new pixel 
color value is not passed to the write mask, no update occurs. Notice that the source color Is used for 
the comparison, as opposed to the destination (bitmap) color used by the standard VGA color compare 
operation. 


ENHANCED MODE PROGRAMMING 5-5 



S3 Vision968 Multimedia Accelerator 



S3 Incorporated 


PIXEL CONTROL REGISTER 
BITS [7:61 


0,0 0,1 1,0 1,1 

i i i i 



NEW PIXEL COLOR pixupdt 


Figure 5-1. Pixel Update Flowchart 
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There are two approaches to determining the new color. One approach is depicted in Figure 5-1 and 
is described next. The second approach is used with the ROPBLT command and is described at the 
end of this section. 

For all commands except a ROPBLT, the new color is the result of a logical mix performed on a color 
source and the current color in the bitmap. For example, the color source could be XORed with the 
bitmap color. The new color can also be selected by operating on only the color source or the bitmap 
color, e.g., NOT color source. Both the color source and the logical mix operation are specified in either 
the Background Mix register (B6E8H) or the Foreground Mix register (BAE8H). Which of these two 
registers is used is determined by the settings of bits [7:6] of the Pixel Control register (BEE8H, Index 
OAH). 

To set up the pixel color updating scheme, the programmer specifies one of four color sources by 
writing bits 6-5 of the Background Mix and Foreground Mix registers. The color sources are: 

• Background Color register {A2E8H) 

• Foreground Color register (A6E8H) 

• CPU (via the Pixel Data Transfer registers (E2E8H, E2EAH)) 

• Current display bitmap color 

One of 16 logical operations is chosen by writing bits 3-0 of the Background Mix and Foreground Mix 
registers. Examples of logical operations are making the new pixel color index equal to the NOT of the 
current bitmap color or making the new color value equal to the XOR of the source and current bitmap 
color values. 

When the logical operation and color source have been specified in the Background and Foreground 
Mix registers, bits 7-6 of the Pixel Control register are written to specify the source of the mask bit 
value. If the resulting mask bit Is a 'ONE', the Foreground Mix register is used to determine the color 
source and mix. If the mask bit is a 'ZERO', the Background Mix register Is used to determine the color 
source and mix. There are three sources for the mask bit value: 

• Always ONE (Foreground Mix register used) 

• CPU (via the Pixel Data Transfer registers (E2E8H, E2EAH)) 

• Bitmap (display) 

Setting bits 7-6 to 00b sets the mask bit to 'ONE'. All drawing updates to the display bitmap use the 
Foreground Mix register settings. This setup is used to draw solid lines, through-the-plane Image 
transfers to display memory and BitBLTs. 

If bits 7-6 are set to 10b, the mask bit source is the CPU. After the draw operation command is issued 
to the Drawing Command register (9AE8), a mask bit corresponding to every pixel drawn on the display 
must be provided via the Pixel Data Transfer register(s). If the mask bit is 'ONE', the Foreground Mix 
register is used. If the mask bit is 'ZERO', the Background Mix register is used. Note that if the color 
source is the CPU, the mask bit source cannot also be the CPU, and vice versa. This setup is used to 
transfer monochrome Images such as fonts and icons to the screen. 

If bits 7-6 are set to 11b, the current display bit map is selected as the mask bit source. The Read Mask 
register (AAE8H) is set up to indicate the active planes. When all bits of the read-enabled planes for a 
pixel are a 1, the mask bit 'ONE' is generated. If any one of the read-enabled planes is a 0, then a mask 
bit 'ZERO' is generated. If the mask bit is 'ONE', the Foreground Mix register is used. If the mask bit is 
'ZERO', the Background Mix register Is used. Note that if the color source Is the bitmap, the mask bit 
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source cannot also be the bitmap, and vice versa. This setting is used to BitBLT patterns and character 
images. 

The ROPBLT command provides 256 raster operations that define the new color. Each operation 
involves one or more of a color source, an off-screen pattern and a destination color. These colors can 
be combined via various logical operations as specified in Appendix A. The source can be the CPU or 
current bitmap and can be color or monochrome. The pattern can also be either color or monochrome. 
The destination is always the current bitmap (screen) and is always color. Certain ROPBLT raster 
operations are equivalent to other commands. For example, if the source is the current bitmap and no 
pattern is used, this is the same operation as a BitBLT. ROPBLTs should not be used for image transfers 
(source is the CPU) when the raster operation does not include a source, e.g., Dn (NOT destination, or 
invert the destination bits). Instead, use the appropriate image transfer command. 

5.4 PROGRAMMING 

Three different programming schemes are available, I/O, standard MMIO and packed register MMIO. 
Examples of how each is used to assign vertical and horizontal coordinates to Current X and Y Position 
registers (82E8H and 86E8H) are: 

I/O Format: 

MOV DX,CUR_X 
MOV AX,X 
OUT DX,AX 
MOV DX,CUR_Y 
MOV AX,Y 
OUT DX,AX 

Standard MMIO Format: 

Enable MMIO 

Point ES to AOOOH (old MMIO) or base address (new MMIO) 

Load X and y values into AX and BX 
MOV ES:[CUR_Y], BX 
MOV ES:[CUR_X], AX 


Packed Register MMIO: 


Enable MMIO 

Point ES to AOOOH (old MMIO) or base address (new MMIO) 

Load the x and y values into EAX (y value in the low word and x value in the high word), 

31 15 0 


EAX 4= 



I.e., 


MOV ES:[ALT_CURXY], EAX 


The packed register MMIO scheme is the most efficient and is used where appropriate in the 
programming examples provided later in this section. All assume that the ES register points to AOOOH 
is the old MMIO is being used or the base address if the new MMIO is being used. 
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5.4.1 Notational Conventions 


The REGMNEMONIC on the left hand side of the arrow is the register mnemonic of the I/O port being 
written into. Text following a is a comment. 


REGMNEMONIC <?= XXXXH 
REGMNEMONIC <?= XXXXD 
REGMNEMONIC <J=XXXX 
REGMNEMONIC ^ XXXXXXXXXXXXXXXXB 


; Load a hexadecimal value into the register. 
; Load a decimal value into the register. 

; Load a decimal value into the register 
; Load a binary value into the register. 


image transfers (CPU pixel data writes to the frame buffer) are notated as follows: 
COUNT 

PIX_TRANS <= IMAGEDATA 


The COUNT Is the number of CPU writes. PIX_TRANS means either the E2E8H, E2EAH pixel transfer 
registers or the 32K memory space from AOOOOH to A7FFFH as explained In Section 5.1.1 above or 
to the alternate 32K area when using the new MMIO as shown in Table 5-2. 


5.4.2 Initial Setup 

All examples assume the desired mode Is selected. 

The Bitmap Access Through the Graphics Engine section earlier In this section explains in detail how 
the colors, mixes and the data extensions are set for each example. These registers need not be set 
repeatedly before a series of draw commands if they use the same colors, mixes and data extension. 

All bitmap updates are affected by the settings in the clipping registers {BEE8H, Indices 1-4) and the 
choice of Internal or external clipping (BEE8H, Index E, bit 5). These must be set up so they include the 
area being drawn into. 

If color compare is to be used, it must be enabled by setting bit 8 of BEE8H, Index OEM to 1. Bit 7 of this 
register determines whether a TRUE or FALSE comparison allows the pixel update to continue. The 
comparison color is programmed Into the Color Compare register (B2E8). 

All planes are enabled for writing unless explicitly set otherwise in an example. This is done via the 
Write Mask register (AAE8H). 
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5.4.3 Programming Examples 

This section provides programming examples for the following Enhanced mode drawing operations: 

• Solid Line 

• Textured Line 

• Rectangle Fill Solid 

• Image Transfer—Through the Plane 

• Image Transfer—Across the Plane 

• BitBLT—Through the Plane 

• BitBLT—Across the Plane 

• PatBLT—Through the Plane 

• PatBLT—Across the Plane 

• Short Stroke Vectors 

• Polyline 

• Polygon Fill Solid 

• Polygon Fill Pattern - 

• 4-Point Method Trapezoid Fill Solid 

• 4-Point Method Trapezoid Fill Pattern 

• Bresenham Parameter Trapezoid Fill Solid 

• Bresenham Parameter Trapezoid Fill Pattern 

• ROPBLT 

• Programmable Hardware Cursor 

Some programming steps are repeated In multiple examples. They are explained in detail at their first 
occurrence. Therefore, readers are encouraged to work through the examples from first to last. The 
register mnemonics used in the examples are listed in Table 5-1. Other mnemonics used are: 

Mnemonic Description 

NEW Mix = 00111 b in bits 4-0 of BAE8H or B6E8H. This overwrites the present 

bitmap color value with a new value. 

XOR Mix = 00101 b in bits 4-0 of BAE8H or B6E8H. The current bitmap color is 

XORed with the new color. 
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5.4.3.1 Solid Line 


This command draws a one pixel wide solid line from screen coordinates x1,y1 to x2,y2. Bresenham 
parameters are used to define the line. The Pixel Control register (BEE8H, Index AH) must be set to 
AOOOH to select the Foreground Mix register to specify the color source and mix type. 

Setup: 

Drawing a line using axial coordinates requires programming the axial step constant into the Destina¬ 
tion Y-Positlon/Axial Step Constant (8AE8H) register (DESTY_AXSTP), the diagonal step constant Into 
the Destination X-Position/Dlagonal Step Constant (8EE8H) register {DESTX_DIASTP) and the error 
term into the Error Term (92E8H) register (ERR_TERM). Calculation of these Bresenham parameters is 
based on the MAX and MIN parameters as calculated below. 

MAX = maximum(ABS(x2-x1), ABS(y2-y1)) 

MIN = mlnlmum(ABS{x2-x1), ABS{y2-y1)) 

where maximum means choose the largest of the two terms In parentheses and minimum means 
choose the smallest. ABS means take the absolute value of the expression. 

Bits 7-5 of the Drawing Command (9AE8H) register (CMD) specify the drawing direction. Setting bit 7 
to 1 means that the Y drawing direction is positive (y1 < y2). Clearing bit 7 to 0 means the Y drawing 
direction is negative (y1 > y2). Setting bit 6 to 1 means that Y is the major (longer) axis (ABS(x2-x1) > 
ABS(y2-y1)). Clearing bit 6 to 0 means that X is the major axis. Setting bit 5 to 1 means that the X 
drawing direction is positive (x1 <x2). Clearing bit 5 to 0 means that the X drawing direction is negative 
{x1 > x2). These values replace the DDD sequence in the write to the CMD register shown in the 
pseudocode below. 

The mix NEW represents a setting of 0111b In bits 3-0 of the Foreground Mix (BAE8H) register 
(FRGD_MIX). This overwrites the present bitmap color value with a new value. 

The remainder of the setup is: 

ES:[FRGD_MIX] <?= 0027H ; color source is FRGD_COLOR, mix type is NEW 

ES:FRGD_COLOR] 00000002H ; color index 

ES:[PIXEL_CNTL] 4= AOOOH ; FRGD_MIX provides color source and mix type 

Drawing Operation: 

31_15_0 

ES:[ALT_CURXY] 4= x1 _ y1 ; set starting coordinate 


ES:[MAJ_AXIS_PCNT] 4= MAX - 1 ; length in pixels of the major axis -1 

3J_15 _0 

ES:[ALT_STEP] 4= 2*(MIN-MAX) 2*MIN ; diagonal and axial step constants 

If the X drawing direction is positive then 

ES:[ERR_TERM] 2 * MIN - MAX ; error term 

else if the X drawing direction is negative 

ES[ERR_TERM] 4= 2 * MIN - MAX - 1 ; error term 

ES:[CMD1 4= OOlOOOOODDDIOOOlb ; Draw line command (bits 15-13, 11), draw (as opposed to 

; just move current posltion)(bit 4), bit 0 is always 1 
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5.4.3.2 Textured Line 

The line draw command can be used to draw a one pixel wide textured line from screen coordinates 
x1,yl to x2,y2. The texture is created by (1) setting bits 7-6 of the Pixel Control register (BEE8H, Index 
AH) to A080H to specify the CPU as the source of the mask bit selecting the mix register, (2) specifying 
a background and foreground color, (3) setting bit 8 of the Command register (9AE8H) to 1 (wait for 
CPU data) and (4) setting bit 1 of the Command register to 1 (multi-pixel). When the pattern bit sent by 
the CPU is a 1, the Foreground Mix register specifies the the color source and mix. When the bit is a 
0, the Background Mix register specifies the color source and mix. This example uses the mix NEW for 
the foreground mix, XOR for the background mix, foreground color index 2 and background color Index 
4. The 32-bit line texture/pattern (PATTERN) is 00110000111100110011000011110011b. This requires 
that bits 10-9 of the Command register be set to 10b to specify a 32-bit bus. 


The XOR mix corresponds to a setting of 0101b in bits 3-0 of the Background Mix (B6E8H) register 
(BKGD_MIX). See the Solid Line example for an explanation of other parameters and registers used in 
this example. 

31 15 0 

ES:[ALT_MIX] 0027H 0005H ; FRGD_COLOR is color source and NEW is mix, 

; BKGD COLOR is color source and XOR is mix 


ES:[FRGD_COLOR] <j= 00000002H ; color index 

ES:[BKGD_COLOR] 4= 00000004H ; color index 

ES:[PIXEL_CNTL] <= A080H ; mask data s 


; mask data selecting mix register is provided by the CPU 


Drawing Operation: 


ES:[ALT_CURXY] 


; set starting coordinates 


ES:[MAJ_AXIS_PCNT MAX - 1 


; length in pixels of the major axis -1 


ES:[ALT_STEP] <= 2*(MIN-MAX) 2*MIN ; diagonal and axial step constants 

If the X drawing direction is positive then 

ES:[ERR_TERM1 4= 2 * MIN - MAX ; error term 

else if the X drawing direction is negative 

ES[ERR_TERM] <= 2 * MIN - MAX - 1 ; error term 

ES:[CMD1 <= OOlOOIOIDDDIOOIIb ; Draw line (bits 15-13,11), 32-bit bus (bits 10-9), wait for data 

; from the CPU (bit 8), draw (bit 4), multi-pixel (bit 1) 

COUNT (of PATTERN dwords) = (MAX + 31)/32 (See Note) 

PIX_TRANS «= 00110000111100110011000011110011b ; Output PATTERN to Pixel Data Transfer 

; registers COUNT times 


The COUNT of the number of writes required by the CPU is a function of the number of bits to be 
transferred and the width of the transfer (8, 16 or 32 bits as specified by bits 10-9 of the Drawing 
Command register (9AE8H)). The number of bits transferred per line must be an even multiple of the 
transfer width. If this is not the case, the last write per line must be padded with one or more dummy 
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bits to meet this requirement. For example, if the transfer width is 8 bits and nine bits are to be 
transferred for the line, two bytes must be written per line, with the upper 7 bits of the second byte 
padded. In general, the number of padding bits per line will vary from 0 to (n-1), where n is the transfer 
width in bits. 

With a transfer width of 8 bits, the number of byte writes required per line can be determined from 
the formula n = (MAX+7)/8, with n being truncated to an integer if the result contains a fraction. 

Thus a MAX = 11 transfer requires (11+7)/8 = 21/4 = 2 bytes. The formulas for all transfer widths are 
given below. 

8-blt transfers: COUNT = {MAX+7)/8 bytes 
16-bit transfers: COUNT = (MAX+15)/16 words 
32-bit transfers: COUNT = {MAX+31)/32 dwords 
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5.4.3.3 Rectangle Fill Solid 

This command draws a solid rectangle with its top left corner at x1,y1, height = HEIGHT and width = 
WIDTH. The Pixel Control register {BEE8H, Index AH) must be set to AOOOH to select the Foreground 
Mix register to specify the color source and mix type. This example uses the mix NEW and color index 
2. The drawing direction (bits 7-5 in the write to the CMD register below) Is set to X positive, X major 
and Y positive (101b). 

Setup: 

ES:[FRGD_MIX] ^ 0027H ; color source is FRGD_COLOR, NEW mix type 

ES:[FRGD_COLOR] <= 00000002H ; color index 

ES:[PIXEL_CNTL] <= AOOOH ; FRGD_MIX specifies the color source and mix type 


Drawing Operation: 
ES:[ALT_CURXY] «= 


31 15 0 


Xl 


yi 


; set starting coordinates 


15 


ES:[ALT_PCNT] ^ 


WIDTH-1 


HEIGHT-1 


; rectangle width 


ES:[CMD] 0100000010110001b ; Draw rectangle (bits 15-13, 11), draw (bit 4) 


Note 


The rectangle can be defined by specifying any one of the four corners and setting bits 7-5 accordingly. 
Always select X as the major axis (bit 6 =0). No matter how the rectangle is defined, it always fills from 
left to right and top to bottom. 


Comer 

X direction (bit 5) 

Y direction (bit 7) 

top left 

positive (1) 

positive (1) 

top right 

negative (0) 

positive (1) 

bottom left 

positive (1) 

negative (0) 

bottom right 

negative (0) 

negative (0) 
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5.4.3.4 Image Transfer—Through the Plane 

This command transfers a rectangular image from the CPU to the display memory through the plane, 
"through the plane" means the complete color index is transferred for each pixel, e.g., in 8 bits/pixel 
mode, one byte is required to transfer one pixel to memory. The image is stored as an array of pixels 
arranged In rowmajorfashion {consecutively Increasing memory addresses). The Pixel Control register 
must be set to AOOOH to select the Foreground Mix register to specify the color source and mix type. 
The color source must be specified as the CPU. Bit 12 of the Command register must be set to 1 (swap 
ON) for Intel-type architectures. Bit 8 of the Command register must be set to 1 (wait for CPU data) and 
bits 6 and 5 must also be set to 1 to specify X as the major axis and a left-to-right drawing direction. 
This example uses a mix type of NEW and x1,y1 Is the top left corner of the rectangle on the screen. 
The height and width of the rectangle (In pixels) are HEIGHT and WIDTH. Doubiword CPU writes are 
supported by setting bits 10-9 of the Command register to 10b. 

Setup; 

ES:[FRGD_MIX] <= 0047H ; color source is the CPU, mix type is NEW 

ES:[PIXEL_CNTL] <= AOOOH ; FRGD_MIX Is the source for color source and mix type 

Drawing Operation: 


ES:[ALT_CURXY] 


x1 


yi 


; set destination starting coordinates 


ES:[ALT_PCNT] 


31 15 0 


WIDTH-1 


HEIGHT-1 


; rectangle width 


Wait for Graphics Engine not busy ; loop till bit 9 of 9AE8H register is 0 

ES:[CMD] ^ 01010101D0110001b ; Draw rectangle (bits 15-13, 11), swap ON (bit 12), 

; 32-bit transfers (bits 10-9), wait for CPU data (bit 8), 

; always X Major (bit 6) & X Positive (bit 5), draw (bit 4) 


COUNT (of image pixel data to transfer) = (See Note) 

PIX_TRANS IMAGEDATA; Output image data to the Pixel Data Transfer registers for COUNT dwords. 


Note 


The COUNT of the number of writes required by the CPU is a function of the number of pixels to be 
transferred, the width of the transfer (8,16 or 32 bits as specified by bits 10-9 of the Drawing Command 
register (9AE8H)) and the color depth (bits/pixel). The number of pixels transferred per line must be an 
even multiple of the transfer width. If this is not the case, the last write per line must be padded with 
one or more dummy pixels to meet this requirement. For example, at 4 bits/pixel, each byte holds two 
pixels. If the transfer width is one byte and three pixels are to be transferred per line, two bytes must 
be written per line, with the upper nibble of the second byte a dummy pixel. If the transfer width Is 16 
bits, from one to three dummy pixels may be required to make the number of pixels per line an even 
multiple of 16. The number of word writes required per line can be determined from the formula n = 
(W+3)/4, with n being truncated to an integer if the result contains a fraction. Thus a six pixel transfer 
requires (6+3)/4 = 2.25 = 2 words. This is then multiplied by the height of the the image (in pixels) to 
determine the COUNT of words to be transferred. Similar procedures apply to every other combination 
of the variables affecting the COUNT. The formulas for all cases are given below, where W is the width 
of the image and H is the height of the Image, both in pixels. 
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COUNT for 4 bits/pixel modes 

8-bit transfers: COUNT = (W+1)/2 * H bytes 
16-bit transfers: COUNT = (W+3)/4 * H words 
32-bit transfers: COUNT = (W+7)/8 * H dwords 

COUNT for 8 bits/pixel modes 

8-bit transfers: COUNT = W * H bytes 
16-bit transfers: COUNT = (W+1)/2 * H words 
32-bit transfers: COUNT = (W+3)/4 * H dwords 

COUNT for 16 bits/pixel modes 

8-bit transfers: Do not use this combination 
16-bit transfers: COUNT = W * H words 
32-bit transfers: COUNT = (W+1)/2 * H dwords 

COUNT for 32 bits/pixel modes 

8-bit transfers: COUNT = Do not use this combination 
16-bit transfers: COUNT = 2W * H words 
32-bit transfers: COUNT = W * H dwords 

Note that in 32 bits/pixel modes, the upper byte is a dummy byte providing padding for a 24-bit 
pixel. 
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5.4.3.5 Image Transfer—^Across the Plane 

The image transfer command can also be used to transfer a rectangular image from the CPU to the 
display memory across the plane, "across the plane" means that each bit sent by the CPU is stored in 
display memory as a single pixel. These pixels are arranged in row major fashion (consecutively 
Increasing memory addresses). An "across the plane" transfer is created by (1) setting bits 7-6 of the 
Pixel Control register (BEE8H, Index AH) to A080H to specify the CPU as the source of the mask bit 
selecting the mix register, (2) specifying a background and foreground color, (3) setting bit 8 of the 
Command register (9AE8H) to 1 (wait for CPU data) and (4) setting bit 1 of the Command register to 1 
(multi-pixel). When the pattern bit sent by the CPU Is a 1, the Foreground Mix register specifies the the 
color source and mix. When the bit is a 0, the Background Mix register specifies the color source and 
mix. This example uses a mix type of NEW, and x1,y1 is the top left corner of the rectangle on the 
screen. The height and width of the rectangle (in pixels) are HEIGHT and WIDTH. The monochrome 
image is translated so that pixels corresponding to a 1 in the bit image are given color index 4 and 
pixels corresponding to a 0 in the bit image are given color index 0. This example uses word transfers 
from the CPU as specified by setting bits 10-9 of the Command register to 01b for a 16-bit bus width. 


0 

_I ; FRGD_COLOR color source and mix Is NEW 

; BKGD_COLOR is color source and mix is XOR 
; foreground color index 4 
; background color index 0 

; selection of mix register is based on data from the CPU 

Drawing Operation: 

31_15_0 

ES:[ALT_CURXY] <= x1 _ y1 ; set destination starting coordinates 

31 15 0 

ES:[ALT_PCNT] | WIDTH-1 | HEIGHT-l] ; rectangle width 

Wait for Graphics Engine not busy ; loop till bit 9 of 9AE8H register is 0 

CMD <= 01010011D0110011b ; Draw rectangle (bits 15-13, 11), swap ON (bit 12), 

; 16-bit transfers (bits 10-9), wait for CPU data (bit 8), 

; always X Major (bit 6) & X Positive (bit 5), draw (bit 4), 

; multi-pixel (bit 1) 

COUNT (of image pixel data to transfer) = ((WIDTH +15)/16)*HEIGHT words 
PIX_TRANS 4= IMAGEDATA; Output image data to Pixel Transfer register for COUNT words 

Notes 

The COUNT of the number of writes required by the CPU is a function of the number of pixels to be 
transferred and the width of the transfer (8,16 or 32 bits as specified by bits 10-9 of 9AE8H). Except for 
the case where bits 10-9 of 9AE8H are 11b, the number of pixels transferred per line must be an even 
multiple of the transfer width. If this Is not the case, the last write per line must be padded with one or 
more dummy pixels to meet this requirement. For example, if the transfer width Is 8 bits and nine 
pixels are to be transferred per line, two bytes must be written per line, with the upper 7 bits of the 
second byte padded. In general, the number of padding bits per line will vary from 0 to (n-1), where n 
is the transfer width in bits. 


Setup: 

31 15 

ES:[ALT_MIX] | 0027H | 0005H 

ES:[FRGD_COLOR] 4= 00000004H 
ES:[BKGD_COLOR] OOOOOOOOH 
ES:[PIXEL_CNTL] A080H 
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With a transfer width of 8 bits, the number of byte writes required per line can be determined from the 
formula n = (W+7)/8, with n being truncated to an integer if the result contains a fraction. Thus a 13-bit 
pixel transfer requires {13+7)/8 = 2.5 = 2 bytes. This is then multiplied by the height of the image (in 
pixels) to determine the COUNT of bytes to be transferred. Similar procedures apply to every other 
combination of the variables affecting the COUNT. The formulas for all cases are given below, where 
W is the width of the image and H is the height of the image, both in pixels. 

8-blt transfers; COUNT = (W+7)/8 * H bytes {9AE8H_10-9 = 00b) 

16-bit transfers: COUNT = (W+15)/16 * H words (9AE8H_10-9 = 01b) 

32-bit transfers: COUNT = (W+31)/32 * H dwords (9AE8H_10-9 = 10b) 

New 32-bit transfers: COUNT = (({W+7)/8*H)+3)/4 dwords (9AE8H_10-9 = 11b) 

The differences between the two 32-bit transfer options are: 

1. For 9AE8H_10-9 set to 10b, every line of the transfer must start with a fresh doubleword. In other 
words, all unneeded bits in a doubleword transfer for a given line are discarded. After a rectan¬ 
gular image is transferred, the current drawing position is a the bottom left, meaning the next 
rectangle, If drawn, will be below the previous rectangle. 

2. For 9AE8H_10-9 set to 11b, only bits from the end of the line width to the next byte boundary are 
discarded. Data for the next line begins with the next byte. After a rectangular Image is trans¬ 
ferred, the current drawing position Is a the top right, meaning the next rectangle. If drawn, 

will be to the right of the previous rectangle. 

To write to a single plane, set the foreground mix to 'logical one' (0002H), the background mix to 'logical 
zero' (0001H), and the Write Mask register (AAE8H) to select the desired (single) plane for updates. 
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5.4.3.6 BitBLT—Through the Plane 

This command copies a source rectangular area in display memory to another location in display 
memory. The Pixel Control register must be set to AOOOH to select the Foreground Mix register to 
specify the color source and mix type. The color source must be specified as the bitmap (display 
memory). Bit 6 of the Command register must be setto 1 to specify X as the major axis. Forthis example, 
assume x1,y1 Is the top left corner of the source rectangle In display memory and x2,y2 is the top left 
corner of the destination rectangle. The rectangles can be overlapping or disjoint. The height and width 
(in pixels) of the rectangle being copied are HEIGHT and WIDTH. 

Setup: 

First, the values of the Srcx, Srcy, Destx and Desty must be determined. 

Case 1: Source and destination rectangles do not overlap 

For X Positive, Y Positive: Srcx = x1, Srcy = y1, Destx = x2, Desty = y2 

Case 2: Source and destination rectangles overlap 

If x1 > x2 

then If X Positive, Srcx = x1, Destx = x2 

else 

Srcx = x1 + WIDTH -1, Desty = x2 + WIDTH -1 ; X Negative 

Ifyl >y2 

then if Y Positive, Srcy = y1, Desty = y2 

else 

Srcy = y1 + HEIGHT -1, Desty = y2 + HEIGHT -1 ; Y Negative 

ES:[PIXEL_CNTL] <= AOOOH ; FRGD_MIX is the source of color source and mix type 

ES:[FRGD_MIX] 0067H ; color source is display memory and mix type is NEW 

Draw Operation: 


31 15 0 


ES:[ALT_CURXY] <= 

Srcx 

Srcy 

; set starting coordinates 

31 

ES:[ALT_STEP1 <= 

15 

Destx 

0 

Desty 

; set destination coordinates 

31 

ES:[ALT_PCNT] <= [ 

15 

WlDTH-1 

0 

HEIGHT-1 

; rectangle width and height 


ES:[CMD] 1 lOOOOOODODIOOOlb ; BitBLT (bits 15-13,11), always X Major (bit 6), draw (bit 4) 
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5.4.3.7 BitBLT—Across the Plane 

This uses the same command as a BitBLT through the plane. However, instead of copying complete 
pixels (with color affected only by the mix), this 'across the plane" transfer uses only the bits in the 
color planes specified by setting the Read Mask register (AEE8H), e.g., bit 3 of every pixel, to determine 
the destination rectangle. With more than one plane enabled for read, if all the bits in the planes enabled 
for read are 'Vs then a 'V is read. If a bit in any one of the planes enabled for read is a 'O', then '0' is 
read. An "across the plane" transfer Is created by (1) setting bits 7-6 of the Pixel Control register (BEE8H, 
Index AH) to AOCOH to specify the bitmap as the source of the mask bit selecting the mix register, (2) 
programming the Read and Write Mask registers to specify the plane to read from and write to and (3) 
setting bit 1 of the Command register to 1 (multi-pixel). In this example, when the bit read is a 1, a 1 is 
copied as specified by the foreground mix. When the bit read is a 0, a 0 is copied as specified by the 
background mix. Assume x1,y1 is the top left corner of the source rectangle on the display, and x2,y2 
is the top left corner of the destination rectangle. The image is read from plane 0 and written to plane 
2. The rectangles could be overlapping or disjoint. The height and width (in pixels) of the rectangle are 
HEIGHT and WIDTH. 

Setup: 

First, the values of the Srcx, Srcy, Destx and Desty must be determined. 

Case 1: Source and destination rectangles do not overlap 

For X Positive, Y Positive: Srcx = x1, Srcy = y1, Destx = x2, Desty = y2 

Case 2: Source and destination rectangles overlap 

If x1 > x2 

then if X Positive, Srcx = x1, Destx = x2 

else 

Srcx = x1 + WIDTH -1, Desty = x2 + WIDTH -1 ; X Negative 

Ifyl >y2 

then if Y Positive, Srcy = y1, Desty = y2 

else 

Srcy = y1 + HEIGHT -1, Desty = y2 + HEIGHT -1 ; Y Negative 

; data from display memory selects mix register 
0 

_1 ; result of foreground mix is always logical 1, 

; result of background mix is always logical 0 
; read from plane 0 
; plane 2 enabled for write 


ES:IPIXEL_CNTL] <?= AOCOH 

31 15 

ES:[ALT_MIX] | 0002H | 0001H 

ES:[RD_MASK] ^ 00000001H 
ES:[WRT_MASK1 00000004H 
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Draw Operation: 


ES:[ALT_CURXY] 4= 

Srcx 

Srcy 

31 

15 

0 

ES:[ALT_STEP] <= 

Destx 

Desty 


31 

15 

0 

ES:[ALT_PCNT] <= 

WIDTH-1 

HEIGHT-1 



; set starting coordinates 
; set destination coordinates 
; rectangle width and height 


ES:[CMD] 11000000D0D10001b ; BitBLT (bits 15-13, 11), always X Major (bit 6), draw (bit 4), 

; multi-pixel (bit 1) 


Note 


It is possible to translate a monochrome image, e.g., text fonts, stored in a single plane in display 
memory into a 2-color Image. This is accomplished by setting the mix registers differently and setting 
the desired background and foreground colors. If the source bit is a 'V, then the corresponding pixel 
at the destination Is colored with the foreground color index. The destination pixel is colored with the 
background color index if the corresponding source bit is a 'O'. The setup for this is as follows: 


ES:[WRT_MASK] FFFFFFFFH 
ES:[FRGD_MIX] 0027H 
ES:[BKGD_MIX] <j= 0007H 
ES:[FRGD_COLOR] 00000004H 
ES:[BKGD_COLOR] <= 00000001H 


; enable all planes for writing 
; color source foreground, mix type NEW 
; color source background, mix type NEW 
; foreground color 
; background color 
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5.4.3.8 PatBLT—Pattern Fill Through the Plane 

An 8x8 pixel pattern is initially copied into an off-screen area of display mennory using an image transfer 
operation or a direct write (linear addressing). This command then repeatedly tiles this source pattern 
into a destination rectangle of arbitrary size. The colors of the destination pixels are affected only by 
the mix selected. The destination rectangle must not overlap the source pattern. Each copy is aligned 
to an 8-pixel boundary (x coordinate = 0,8, etc.), with pixels outside the destination rectangle boundary 
not being drawn. The Pixel Control register must be set to AOOOH to select the Foreground Mix register 
to specify the color source and mix type. The color source must be specified as the bitmap (display 
memory). Bit 6 of the Command register must be set to 1 to specify X as the major axis. In this example, 
assume x1 ,y 1 is the top left corner of the pixel pattern and x2,y2 Is the top left corner of the destination 
rectangle. The height and width (in pixels) of the rectangle are HEIGHT and WIDTH. 

Setup; 

ES:[PIXEL_CNTL] 4= AOOOH ; FRGD_MIX Is the source of color source and mix type 

ES;[FRGD_MIX] <= 0067H ; color source is display memory, mix type is NEW 

Draw Operation 

31 15 0 

ES;[ALT_CURXY] 4= x1 _ y1 ; set starting coordinates 

31 15 0 

ES:[ALT_STEP] 4= x2 _ y2 ; set destination coordinates 

31 15 0 

ES:[ALT_PCNT] 4 = WlDTH-1 HEIGHT-1 ; rectangle width and height 

ES:[CMD] 4= 11 lOOOOODODIOOOlb ; PatBLT (bits 15-13,11), always X Major (bit 6), draw (bit 4) 
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5.4.3.9 PatBLT—Pattern Fill Across the Plane 

This uses the same command as a PatBLT through the plane. However, instead of copying complete 
pixels (with color affected only by the mix), this 'across the plane" transfer uses only the bits in the 
color planes specified by setting the Read Mask register (AEE8H), e.g., bit 3 of every pixel, to determine 
the destination rectangle. With more than one plane enabled for read. If all the bits in the planes enabled 
for read are '1's then a '1' Is read. If a bit in any one of the planes enabled for read is a 'O', then '0' is 
read. An "across the plane" transfer is created by (1) setting bits 7-6 of the Pixel Control register (BEE8H, 
Index AH) to AOCOH to specify the bitmap as the source of the mask bit selecting the mix register, (2) 
programming the Read and Write Mask registers to specify the plane to read from and write to and (3) 
setting bit 1 of the Command register to 1 (multi-pixel). In this example, when the bit read is a 1, a 1 is 
copied as specified by the foreground mix. When the bit read is a 0, a 0 is copied as specified by the 
background mix. In this example, assume x1,y1 is the top left corner of the pixel pattern and x2,y2 is 
the top left corner of the destination rectangle. The image is read from plane 0 and written to plane 2. 
The height and width of the destination rectangle are HEIGHT and WIDTH. 

Setup: 

; data from display memory selects mix register 
_o 

_I ; result of foreground mix is always logical 1, 

; result of background mix is always logical 0 
; read from plane 0 
; plane 2 enabled for write 

Draw Operation: 

31 15 0 

ES:[ALT_CURXY] <= x1 y1 ; set starting coordinates 

31_15_0 

ES:[ALT_STEP] <= x2 _ y2 ; set destination coordinates 

31 15 0 

ES:[ALT_PCNT1 | WIDTH-1 | HEIGHT-l] ; rectangle width and height 

ES:[CMD] <= 11 lOOOOODODIOOIIb ; PatBLT (bits 15-13, 11), always X Major (bit 6), draw (bit 4), 

; multi-pixel (bit 1) 

Note 

To expand the source mono pattern Into a 2-color pattern, set the foreground mix to 27H, the 
background mix to 7H and the foreground and background colors as desired. Also set the write mask 
(AAE8H) to FFFFFFFFH. This needs to be set only once. It is altered only by another write. 


ES:[PIXEL_CNTL] AOCOH 

31 15 

ES:[ALT_MIX] | 0002H | 0001H 

ES:[RD_MASK] <= 00000001H 
ES:[WRT_MASK] 00000004H 
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ENHANCED MODE PROGRAMMING 5-23 








S3 Vis!on968 Multimedia Accelerator 



S3 incorporated 


5.4.3.10 Short Stroke Vectors 


This command rapidly draws short lines (up to 15 pixels in length). Such lines are constrained to one 
of the 8 directions at 45 degree increments starting at 0 degrees. The current point x1,y1 is set and a 
NOP command is issued to set all the desired drawing parameters without actually writing a pixel. For 
example, bit 2 (Last Pixel Off) would be set to 1 (OFF) for drawing connected lines until the last line is 
drawn. The short stroke vector parameters are then loaded in the Short Stroke Vector Transfer (9EE8H) 
register (SHORT_STROKE). Two vectors can be defined at a time, one in the low byte and one in the 
high byte. For the low byte, bits [7:5] define the direction, with bit 4 set to 'V for a draw operation or 
to '0' for a move current position operation. Bits 3-0 define the length of the short line. Let SSVDO, 
SSVD1, ...SSVDN-1 bytes be the short stroke vector data for N lines. 

Setup: 


ES:[PIXEL_CNTL] <= AOOOH ; FRGD_MIX is the source of color source and mix type 

ES:[FRGD_MIX] 0027H ; use the foreground color, mix type NEW 

ES:[FRGD_COLOR]<i= 00000004H ; foreground color index 4 


Draw Operation: 
ES:[ALT_CURXY] 


31 15 0 


Xl 


yi 


; set starting coordinates 


ES:[CMD] <= OOOIOOIOXXXnnib ; NOP (bits 15-13,11), byte swap (bit 12), 16-bit transfers 

; (bits 10-9), draw (bit 4), radial drawing direction (bit 3), 

; last pixel off (bit 2), multi-pixel (bit 1) 

While space available in the FIFO 

ES:[SHORT_STROKE] <= SSVD1 SHL 8 + SSVDO; SSVD1 shifted to high byte, SSVDO in low byte 
ES:[SHORT_STROKE] <^= SSVD3 SHL 8 + SSVD2; byte swap turned on to read vectors out in 

; correct order 


ES:[SHORT_STROKE] SSVDN-1 SHL 8 + SSVDN-2 


5-24 ENHANCED MODE PROGRAMMING 





S3 Vision968 Multimedia Accelerator 


S3 Incorporated 


5.4.3.11 Polyline/2-Point Line 


This command draws a line from point PI {x1,y1) to point P2 (x2,y2). It can be used to draw an additional 
linefromthe end point ofthe lastlinedrawn by specifying only the next end point. This can be repeated 
for as many polyline segments as desired. The Pixel Control register must be set to AOOOH to select 
the Foreground Mix register to specify the color source and mix type. The colorsource must be specified 
as the foreground color. 

Setup: 


ES:[FRGD_MIX] 0027H 
ES:[FRGD_COLOR]<^ 00000002H 
ES:[PIXEL_CNTL1 AOOOH 


; color source is FRGD_COLOR, NEW mix type 
; color index 

; FRGD_MIX specifies the color source and mix type 


Draw Operation: 

31 

15 

0 

ES;[ALT_CURXY] <= I x1 

yi 

31 15 

0 


ES:[ALT_STEP] 

x2 

y2 



; set starting coordinates 


; set destination coordinates 


ES:[CMD]<= 0010100000010001b ; draw 2-point line (bits 15-13, 11), draw (bit 4) 


Repeat the last two instructions to draw additional polyline segments. 


Note 


This command is faster for drawing a 2-point line than the Solid Line drawing command. However, 
the Bresenham parameters are fixed in hardware and cannot be manipulated by the programmer as 
with the Solid Line command. A textured line cannot be drawn with this command. 
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5.4.3.12 Polygon Fill Solid 

This command draws a polygon and fills it with a solid color. Any number of edges can be drawn, but 
the shape must be such that any horizontal line must intersect the polygon edges In no more than two 
places. To accomplish this, all edge segments must be drawn downward. The exception is that any 
edge can be horizontal. The Pixel Control register must be set to AOOOH to select the Foreground Mix 
register to specify the color source and mix type. This example uses the mix NEW and color Index 2. 
This example shows how to draw the polygon shown In Figure 5-2. 


x1,y1 



x7,y7 x8,y8 

STEPl STEP 2 STEPS STEP 4 STEP 5 poly 

Figure 5-2. Polygon Example Drawing Steps 

Setup: 

ES:[FRGD_MIX] ^ 0027H ; color source is FRGD_COLOR, NEW mix type 

ES:[FRGD_COLOR] 00000002H ; color index 

ES:[PIXEL_CNTL1 4= AOOOH ; FRGD_MIX specifies the color source and mix type 

Draw Operation: 

31_15_0 

ES:IALT_CURXY] <= x1 _ y1 ; set starting coordinates for segment 1 of left side 

31 15 0 

ES:[ALT_STEP] ^ x2 y2 ; set destination coordinates for segment 1 of left side 

31 15 0 

ES:[ALT_CURXY2] <= x1 y1 ; set starting coordinates for segment 1 of right side 

31 15 0 

ES:[ALT_STEP2I <= x3 y3 ; set destination coordinates for segment 1 of right side 

ES:[CMD]<= 0110000000010001b ; draw polygon (bits 15-13, 11), draw (bit 4) - Step 1 

31 15 0 

ES:[ALT_STEP2] 4= ^^4 ^ ; set destination coordinates for segment 2 of right side 

ES:[CMD]<^ 0110000000010001b ; draw polygon (bits 15-13, 11) - Step 2 

31 15 0 

ES:[ALT_STEP] 4= I x5 I y5 I ; set destination coordinates for segment 2 of left side 
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ES:[CMD]4= 0110000000010001b ; draw polygon (bits 15-13, 11) - Step 3 

31 15 0 

ES:[ALT_STEP] < ' 


x6 


y6 


; set destination coordinates for segnnent 3 of left side 


ES:[CMD]<i= 0110000000010001b ; draw polygon (bits 15-13, 11)-Step 4 

31 15 0 


ES:[ALT_STEP] < 


ES:[ALT_STEP2] < 


x7 


y7 


15 


x8 


y8 


; set destination coordinates for segment 4 of left side 


; set destination coordinates for segment 3 of right side 


ES:[CMD]<^ 0110000000010001b ; draw polygon (bits 15-13, 11) - Step 4 

The generation of this polygon is summarized in the following table. 


Table 5>4. Polygon Fill Example Summary 



First Line 

Second Line 


ALT_CURXY 

ALT_STEP 

ALT_CURXY2 

ALT_STEP2 

Step 1 

Xl 

vi 

x2 

V2 

xl 

yi 

x3 

y3 

CMD 









Step 2 







x4 

y4 

CMD 









Step 3 



x5 

y5 





CMD 









Step 4 



x6 

y6 





CMD 









Step 5 



x7 

y7 



x8 

y8 

CMD 










Notes 

1. The current y for the first two line segments must be the same (y 1 in the example). The current x 
for these two line segments can be the same (point) or different (horizontal top edge). 

2. The fill proceeds downward until it reaches an end point for one of the edges. The next line seg¬ 
ment is then drawn as an extension of this edge, with the fill again stopping at the first end 
point it reaches. For example, note how after segment 2 of the right side is drawn to x4,y4, the 
fill stops at x2,y2 of the first segment of the left side. 

3. Segment 3 of the left side ends at the same vertical position as segment 2 of the right side (Step 
4). When this occurs, both edges of the polygon must be extended by the next command. This 
is shown in Step 5. 

4. For the step that closes the polygon (Step 5 In the example), the destination y positions must be 
be the same (y7 = y8 in the example) for the two line segments making the closure. As with 

the top edge, the x positions may be different (forming a horizontal bottom edge) or the same 
(a point). 

5. When two lines join or cross at an angle other than 90 degrees, the common pixel will not be 
drawn. 
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5.4.3.13 Polygon Fill Pattern 

This command operates exactly as the polygon fill solid except that an 8x8 pixel pattern is tiled into 
the polygon Instead of a solid color. The 8x8 pattern can either be color or mono and must first be 
programmed into off-screen memory using an image transfer or linear addressing. The colors of the 
destination pixels are affected only by the mix selected. The destination polygon must not overlap the 
source pattern. Each copy is aligned to an 8-pixel boundary (x coordinate = 0,8, etc.), with pixels outside 
the destination polygon boundary not being drawn. For a color pattern, the Pixel Control register must 
be set to AOOOH to select the Foreground Mix register to specify the color source and mix type. The 
color source must be specified as the bitmap (display memory). For a mono pattern, the Pixel Control 
register must be set to AOCOH to select the bitmap as the source of the mask bit selecting the mix 
register. If the pattern bit Is a 1, the Foreground Mix register is chosen, which must be programmed 
to select the foreground color. If the pattern bit is a 0, the Background Mix register is chosen, which 
must be programmed to select the background color. 

Setup: (Color Pattern) 

ES:[PIXEL_CNTL] <^= AOOOH ; FRGD_MIX is the source of color source and mix type 

ES:[FRGD_MIX] <= 0067H ; color source is display memory, mix type Is NEW 

31 15 0 

ES:[ALT_PAT] <= PAJ_X PAT_Y . coordinates of upper left hand corner of 8x8 pattern 

Draw Operation: (Color Pattern) 

Same as for polygon fill solid except 

ES:[CMD]<= 01101000000010001b ; draw polygon with pattern fill (bits 15-13,11) 

is substituted for each of the command lines. 

Setup: (Mono Pattern) 

31_15_0 

ES:[ALT_MIX1 <J= 0027H 0005H ; FRGD_COLOR color source and mix is NEW 

; BKGD_COLOR is color source and mix is XOR 
ES:[FRGD_COLOR] <= 00000004H ; foreground color index 4 

ES:[BKGD_COLOR] ^ OOOOOOOOH ; background color index 0 

ES:[PIXEL_CNTL] <= AOCOH ; selection of mix register Is based on data from the screen 

31 15 0 

ES:[ALT_PAT] 4= PAT_X PAT_Y ; coordinates of upper left hand corner of 8x8 pattern 

Draw Operation: (Mono Pattern) 

Same as for polygon fill solid except 

ES:[CMD]4= 0110100000010011b ; draw polygon with pattern fill (bits 15-13, 11), 

; multi-pixel (bit 1) 

is substituted for each of the command lines. 
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5.4.3.14 4-Point Trapezoid Fill Solid 

This command draws a solid trapezoid specified by edge 1 [points PI (x1,y1) and P2 (x2,y2)] and edge 
2 [points P3 (x3,y3) and P4 (x4,y4)]. P1 and P3 must be on the same horizontal line and P2 and P4 must 
be on a different lower horizontal line. The Pixel Control register must be set to AOOOH to select the 
Foreground Mix register to specify the color source and mix type. This example uses the mix NEW and 
color index 2. 


P2 




P4 


Setup: 


ES:[FRGD_MIX] 0027H 
ES:[FRGD_COLOR] 4= 00000002H 
ES:[PIXEL_CNTL] 4= AOOOH 


; color source is FRGD_COLOR, NEW mix type 
; color index 

; FRGD_MIX specifies the color source and mix type 


Draw Operation: 
ES:[ALT_CURXY] 


31 15 0 


Xl 


yi 


ES:[ALT_STEP] < 


x2 


y2 


31 



; set starting coordinates for edge 1 
; set destination coordinates for edge 1 
; set starting coordinates for edge 2 
; set destination coordinates for edge 2 


ES:[CMD]<4= 1000000000010001b ; draw 4-point trapezoid (bits 15-13, 11), draw (bit 4) 


Note 


The y coordinates for line 2 (y3 and y4) are not required. If they are programmed, they must be the 
same as y1 and y2 respectively. 
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5.4,3.15 4-point Trapezoid Fill Pattern 

This command operates exactly as the 4-point trapezoid fill solid except that an 8x8 pixel pattern is 
tiled into the trapezoid instead of a solid color. The 8x8 pattern can either be color or mono and must 
first be programmed into off-screen memory using an image transfer or linear addressing. The 
destination trapezoid must not overlap the source pattern. Each copy Is aligned to an 8-pixel boundary 
(x coordinate = 0, 8, etc.), with pixels outside the destination trapezoid boundary not being drawn. For 
a color pattern, the Pixel Control register must be set to AOOOH to select the Foreground Mix register 
to specify the color source and mix type. The color source must be specified as the bitmap (display 
memory). For a mono pattern, the Pixel Control register must be set to AOCOH to select the bitmap as 
the source of the mask bit selecting the mix register. If the pattern bit is a 1, the Foreground Mix register 
is chosen, which must be programmed to select the foreground color. If the pattern bit Is a 0, the 
Background Mix register is chosen, which must be programmed to select the background color. 

Setup: (Color Pattern) 

ES:[PIXEL_CNTL] 4= AOOOH ; FRGD_MIX is the source of color source and mix type 

ES:[FRGD_MIX] <= 0067H ; color source is display memory, mix type is NEW 

31 15 0 

ES:[ALT_PAT] <= PAT_X PAT_Y ; coordinates of upper left hand corner of 8x8 pattern 

Draw Operation: (Color Pattern) 

Same as for 4-point trapezoid fill solid except the command is as follows: 

ES:[CMD]<j= 0110100000010001b ; draw trapezoid with pattern fill (bits 15-13,11) 


0 

_I ; FRGD_COLOR color source and mix Is NEW 

; BKGD_COLOR is color source and mix Is XOR 
; foreground color Index 4 
; background color index 0 

; selection of mix register is based on data from the screen 
__ 0 

ES:[ALT_PAT] 4= PAT_X PAT_Y ; coordinates of upper left hand corner of 8x8 pattern 

Draw Operation: (Mono Pattern) 

Same as for 4-point trapezoid fill solid except the command is as follows: 

ES:[CMD]<j= 1000100000010011b ; draw trapezoid with pattern fill (bits 15-13, 11), multi-pixel (bit 1) 


Setup: (Mono Pattern) 

31 15 

ES:IALT_MIX] <= | 0027H | 0005H 

ES:[FRGD_COLOR] <= 00000004H 
ES:[BKGD_COLOR] 4= OOOOOOOOH 
ES:[PIXEL_CNTL] <= AOCOH 

31 15 
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5.4.3.16 Bresenham Parameter Trapezoid Fili Soiid 

This command operates exactly as the 4-polnt trapezoid fill solid except the two edges are drawn with 
Bresenham parameters specified by the programmer. Calculation of these Bresenham parameters is 
based on the MAX and MIN parameters as calculated below. 

MAX = maximum{ABS(x2-x1), ABS(y2-y1)) 

MIN - minlmum(ABS(x2-x1), ABS(y2-y1}) 

where maximum means choose the largest of the two terms In parentheses and minimum means 
choose the smallest. ABS means take the absolute value of the expression. The fill must proceed 
downward (Y positive). 

Setup: 

ES:[FRGD_MIX] <^= 0027H ; color source is FRGD_COLOR, NEW mix type 

ES:[FRGD_COLOR] 00000002H ; color index 

ES:[PIXEL_CNTL] AOOOH ; FRGD_MIX specifies the color source and mix type 

Draw Operation 


31 


ES:[ALT_CURXY] 4= 


x1 


yi 


ES:[MAJ_AXIS_PCNT] <j= MAX - 1 

3J_ 

ES:[ALT_STEP] <=|2*(MIN-MAX) 


; length in 
_ 0 


2*MIN 


set starting coordinate for edge 1 
pixels of the major axis - 1 for edge 1 
diagonal and axial step constants for edge 1 


If the X drawing direction is positive then 
ES:[ERR_TERM] ^ 2 * MIN - MAX 
else if the X drawing direction is negative 
ES[ERR_TERM] ^ 2 * MIN - MAX - 1 

31 15 0 


ES:[ALT_CURXY2] < 


x2 


y2 


ES:[MAJ_AXIS_PCNT2] MAX - 1 
31 15 

ES:[ALT_STEP2] < 


; length in 
0 


2*{MIN-MAX) 


2*MIN 


error term for edge 1 

error term for edge 1 

set starting coordinate for edge 2 

pixels of the major axis - 1 for edge 2 

diagonal and axial step constants for edge 2 


If the X drawing direction Is positive then 

ES:IERR_TERM] 2 * MIN - MAX ; error term for edge 2 

else if the X drawing direction is negative 

ES[ERR_TERM] 2 * MIN - MAX - 1 ; error term for edge 2 

ES:[CMD2]<= 000000001 DDOOOOOb ; edge 2 drawing direction (bits 7-5) 

ES:[CMD]<J= 101000001DD10001b ; draw Bresenham parameter trapezoid (bits 15-13, 11) 

; edge 1 drawing direction (bits 7-5), draw (bit 4) 

Note that the last two instructions can be packed, i.e, ES:[ALT_CMD], with CMD in the lower word 
(15-0) and CMD2 in the upper word (31-16). If they are not packed, CMD2 must precede CMD as 
shown. 
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5.4.3.17 Bresenham Parameter Trapezoid Fill Pattern 

This command operates exactly as the Bresenham parameter trapezoid fill solid except that an 8x8 
pixel pattern is tiled into the trapezoid instead of a solid color. The 8x8 pattern can either be color or 
mono and must first be programmed into off-screen memory using an image transfer or linear 
addressing. The destination trapezoid must not overlap the source pattern. Each copy Is aligned to an 
8-plxel boundary (x coordinate = 0, 8, etc.), with pixels outside the destination trapezoid boundary not 
being drawn. For a color pattern, the Pixel Control register must be set to AOOOH to select the 
Foreground Mix register to specify the color source and mix type. The color source must be specified 
as the bitmap (display memory). For a mono pattern, the Pixel Control register must be set to AOCOH 
to select the bitmap as the source of the mask bit selecting the mix register. If the pattern bit is a 1, the 
Foreground Mix register is chosen, which must be programmed to select the foreground color. If the 
pattern bit is a 0, the Background Mix register is chosen, which must be programmed to select the 
background color. 

Setup: (Color Pattern) 

ES:[PIXEL_CNTL] <= AOOOH ; FRGD_MIX Is the source of color source and mix type 

ES:[FRGD_MIX] <= 0067H ; color source is display memory, mix type Is NEW 

31 15 0 

ES:[ALT_PAT] <= PAT_X PAT_Y ; coordinates of upper left hand corner of 8x8 pattern 

Draw Operation: (Color Pattern) 

Same as for Bresenham parameter trapezoid fill solid except the command is as follows: 

ES:[CMD]4= 101010001 DD10011b ; draw Bresenham parameter trapezoid with pattern fill 

;(bits 15-13, 11) 

Setup: (Mono Pattern) 

31 15 0 

ES:[ALT_MIX] 4=1 0027H 0005H ^ FRGD_COLOR color source and mix Is NEW 

-- ; BKGD_COLOR is color source and mix Is XOR 

ES:[FRGD_COLOR] 4= 00000004H ; foreground color index 4 

ES:[BKGD_COLOR] ^ OOOOOOOOH ; background color index 0 

ES:[PIXEL_CNTL] 4= AOCOH ; selection of mix register is based on data from the screen 

31 15 0 

ES:[ALT_PAT] <= PAT_X PAT_Y ; coordinates of upper left hand corner of 8x8 pattern 

Draw Operation: (Mono Pattern) 

Same as for Bresenham parameter trapezoid fill solid except the command Is as follows: 

ES:[CMD]4= 101010001DD10011b ; draw Bresenham parameter trapezoid with pattern fill 

; (bits 15-13, 11), multi-pixel (bit 1) 
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5.4.3.18 ROPBLTs 

The ROPBLT function provides a full implementation of the 256 raster operations as defined by 
Microsoft for Windows. A listing and explanation of these is provided in Appendix A. 

Each raster op has three operands: Source, Pattern and Destination. The Source pixel can be from the 
screen (current bitmap) or from the CPU (image transfer). When the source is the screen, the pixel 
depth is always the same for both the source and destination (4, 8, 16, 24/32 bits/pixel). When the 
source is the CPU, the pixel can be either color (same source and destination pixel depth) or mono (1 
blt/pixel). 

The Pattern Is an 8x8 array of pixels located in off-screen memory. The pixels are either color or mono. 
If mono, pattern foreground and background registers define the pixel colors. 

The Destination pixel is always the screen (current bitmap) and Is always color (multi bits/pixel). This 
is the pixel that will be overwritten or left unchanged by the result of the operation. 

Based on the above definitions, there are 6 valid ROPBLT cases: 

Color Pattern 

• Source = Screen, Color Pixels 

• Source = CPU, Color Pixels 

• Source = CPU, Mono Pixels 

Mono Pattern 

• Source = Screen, Color Pixels 

• Source = CPU, Color Pixels 

• Source = CPU, Mono Pixels 

Programming examples for each of these cases are provided on the following pages. 
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Color Pattern Case 1 (Source = Screen, Color Pixels) 

This command copies a source rectangular area in display memory to another location in display 
memory. The Pixel Control register must be set to AOOOH to select the Foreground Mix register to 
specify the color source. The color source must be specified as the bitmap (screen). The 8x8 pixel 
pattern must be copied to off-screen memory on an 8-pixel horizontal boundary and its location 
specified. Bit 6 of the Command register must be set to 1 to specify X as the major axis. For this example, 
assume x1,y1 is the top left corner of the source rectangle in display memory and x2,y2 is the top left 
corner of the destination rectangle. The rectangles can be overlapping or disjoint. The height and width 
(In pixels) of the rectangle being copied are HEIGHT and WIDTH. 

Setup: 

First, the values of the Srcx, Srcy, Destx and Desty must be determined. 

Case 1: Source and destination rectangles do not overlap 

For X Positive, Y Positive: Srcx = x1, Srcy = y1, Destx = x2, Desty = y2 

Case 2: Source and destination rectangles overlap 

If x1 >x2 

then if X Positive, Srcx = x1, Destx = x2 

else 

Srcx = x1 + WIDTH -1, Destx = x2 + WIDTH -1 ; X Negative 

If y1 >y2 

then if Y Positive, Srcy = y1, Desty = y2 

else 

Srcy = y1 + HEIGHT -1, Desty = y2 + HEIGHT -1 ; Y Negative 

ES:[PIXEL_CNTU ^ AOOOH ; FRGD_MIX is the source of color source 

ES:[FRGD_MIX1 «= 006XH ; color source is screen, mix type is ignored 

ES:[ROPMIX] <= OOXXH ; color pattern flag, XX = ROP code 


Draw Operation: 

31 15 0 


ES:[ALT_PAT1 <= 

Patx 

Paty 

; set starting coordinates for pattern 

31 

15 0 


ES:[ALT_CURXY] <?= 

Srcx 

Srcy 

; set starting coordinates 

31 

ES;[ALT_STEP] <= [ 

Destx 

15 0 

Desty 

; set destination coordinates 

31 

ES;[ALT_PCNT] <= [ 

WIDTH-1 

15 0 

HEIGHT-1 

; rectangle width and height 


ES:[CMD] <= 1 lOOIOOODODIOOOlb ; ROPBLT (bits 15-13, 11), always X Major (bit 6), draw (bit 4) 
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Color Pattern Case 2 (Source = CPU, Color Pixels) 

This command transfers a rectangular image from the CPU to the display memory through the plane, 
"through the plane" means the complete color index is transferred for each pixel, e.g.. In 8 bits/pixel 
mode, one byte is required to transfer one pixel to memory. The Image is stored as an array of pixels 
arranged in row major fashion (consecutively increasing memory addresses). The Pixel Control register 
must be set to AOOOH to select the Foreground Mix register to specify the color source. The color source 
must be specified as the CPU. ROP codes without a source operand must not be used. The 8x8 pixel 
pattern must be copied to off-screen memory on an 8-plxel horizontal boundary and its location 
specified. Bit 12 of the Command register must be set to 1 (swap ON) for Intel-type architectures. Bit 
8 of the Command register must be set to 1 (wait for CPU data) and bits 6 and 5 must also be set to 1 
to specify X as the major axis and a left-to-right drawing direction. For this example, x1,y1 is the top 
left corner of the rectangle on the screen. The height and width of the rectangle (in pixels) are HEIGHT 
and WIDTH. Doubiword CPU writes are supported by setting bits 10-9 of the Command register to 10b. 

Setup: 


ES:[PIXEL_CNTL] <= AOOOH 
ES:[FRGD_MIX]<=004XH 
ES:[ROPMIX] OOXXH 


; FRGD_MIX is the source for color source 
; color source is the CPU, mix type is ignored 
; color pattern flag, XX = ROP code 


Drawing Operation: 

31 15 0 


ES:[ALT_PAT] <t=[[ 

Patx 

Paty 

; set starting coordinates for pattern 

31 

ES:[ALT_STEP] «= [ 

15 

Xl 

0 

y1 

; set destination starting coordinates 

31 

ES;[ALT_PCNT] <=[ 

15 

WIDTH-1 

0 

HEIGHT-1 

; rectangle width 


Wait for Graphics Engine not busy ; loop till bit 9 of 9AE8H register is 0 
ES:[CMD]<?= IIOOIIOIDOIIOOOlb ; ROPBLT (bits 15-13, 11), swap ON (bit 12), 

; 32-blt transfers (bits 10-9), wait for CPU data (bit 8), 

; always X Major (bit 6) & X Positive (bit 5), draw (bit 4) 


COUNT (of image pixel data to transfer) = (See Note) 

PIX_TRANS <= IMAGEDATA; Output image data to the Pixel Data Transfer registers for COUNT dwords. 


Note 


The COUNT of the number of writes required by the CPU is a function of the number of pixels to be 
transferred, the width of the transfer (8,16 or 32 bits as specified by bits 10-9 of the Drawing Command 
register (9AE8H)) and the color depth (bits/pixel). The number of pixels transferred per line must be an 
even multiple of the transfer width. If this is not the case, the last write per line must be padded with 
one or more dummy pixels to meet this requirement. For example, at 4 bits/pixel, each byte holds two 
pixels. If the transfer width is one byte and three pixels are to be transferred per line, two bytes must 
be written per line, with the upper nibble of the second byte a dummy pixel. If the transfer width Is 16 
bits, from one to three dummy pixels may be required to make the number of pixels per line an even 
multiple of 16. The number of word writes required per line can be determined from the formula n = 
(W+3)/4, with n being truncated to an integer if the result contains a fraction. Thus a six pixel transfer 
requires (6+3)/4 = 2.25 = 2 words. This is then multiplied by the height of the the image (in pixels) to 
determine the COUNT of words to be transferred. Similar procedures apply to every other combination 
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of the variables affecting the COUNT. The formulas for all cases are given below, where W Is the width 
of the Image and H is the height of the image, both in pixels. 

COUNT for 4 bits/pixel modes 

8-bit transfers: COUNT = (W+1)/2 * H bytes 
16-bit transfers: COUNT = (W+3)/4 * H words 
32-bit transfers: COUNT = (W+7)/8 * H dwords 

COUNT for 8 bits/pixel modes 

8-blt transfers: COUNT = W * H bytes 
16-bit transfers: COUNT = {W+1)/2 * H words 
32-bit transfers: COUNT = (W+3)/4 * H dwords 

COUNT for 16 bits/pixel modes 

8-bit transfers: Do not use this combination 
16-blt transfers: COUNT = W * H words 
32-bit transfers: COUNT = (W+1)/2 * H dwords 

COUNT for 32 bits/pixel modes 

8-bit transfers: COUNT = Do not use this combination 
16-bit transfers: COUNT = 2W * H words 
32-bit transfers: COUNT = W * H dwords 
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Color Pattern Case 3 (Source = CPU, Mono Pixels) 

This command transfers a rectangular image from the CPU to the display memory across the plane, 
"across the plane" means that each bit sent by the CPU is stored in display memory as a single pixel. 
These pixels are arranged in row major fashion (consecutively increasing memory addresses). An 
"across the plane" transfer is created by (1) setting bits 7-6 of the Pixel Control register to A080H to 
specify the CPU as the source of the mask bit selecting the mix register, (2) specifying a background 
and foreground color, (3) setting bit 8 of the Command register (9AE8H) to 1 (wait for CPU data) and 
(4) setting bit 1 of the Command register to 1 (multi-pixel). ROP codes without a source operand must 
not be used. The 8x8 pixel pattern must be copied to off-screen memory on an 8-plxel horizontal 
boundary and its location specified. When the pattern bit sent by the CPU is a 1, the Foreground Mix 
register specifies the the color source and mix. When the bit is a 0, the Background Mix register specifies 
the color source and mix. For this example, x1,y1 is the top left corner of the rectangle on the screen. 
The height and width of the rectangle (in pixels) are HEIGHT and WIDTH. The monochrome image is 
translated so that pixels corresponding to a 1 in the bit image are given color index 4 and pixels 
corresponding to a 0 in the bit image are given color index 0. This example uses word transfers from 
the CPU as specified by setting bits 10-9 of the Command register to 01b for a 16-blt bus width. 


Setup: 

ES:[ALT_MIX] 4= 


31 15 0 


002XH 


OOOXH 


; FRGD_COLOR is color source 
; BKGD_COLOR is color source 


ES:[FRGD_COLOR] <= 00000004H 
ES:[BKGD_COLOR] OOOOOOOOH 
ES:[PIXEL_CNTL] A080H 
ES:[ROPMIX] OOXXH 


; foreground color index 4 
; background color index 0 

; selection of mix register is based on data from the CPU 
; color pattern flag, XX = ROP code 


Drawing Operation: 

31 15 0 


ES:[ALT_PAT] <= 

Patx 

Paty 

; set starting coordinates for pattern 

31 

ES:[ALT_STEP] <= [_ 

15 

Xl 

0 

yi 

; set destination starting coordinates 

31 

ES:[ALT_PCNT] «= [ 

15 0 

WIDTH-1 HEIGHT-1 

; rectangle width 


Wait for Graphics Engine not busy ; loop till bit 9 of 9AE8H register is 0 
CMD<i= IIOOIOIIDOIIOOIIb ; ROPBLT (bits 15-13,11), swap ON (bit 12), 

; 16-bit transfers (bits 10-9), wait for CPU data (bit 8), 

; always X Major (bit 6) & X Positive (bit 5), draw (bit 4), 
; multi-pixel (bit 1) 


COUNT (of image pixel data to transfer) = ((WIDTH -i-15)/16)*HEIGHT words 

PIX_TRANS <{= IMAGEDATA; Output Image data to Pixel Transfer register for COUNT words 

Notes 


The COUNT of the number of writes required by the CPU is a function of the number of pixels to be 
transferred and the width of the transfer (8,16 or 32 bits as specified by bits 10-9 of 9AE8H). Except for 
the case where bits 10-9 of 9AE8H are 11b, the number of pixels transferred per line must be an even 
multiple of the transfer width. If this is not the case, the last write per line must be padded with one or 
more dummy pixels to meet this requirement. For example. If the transfer width Is 8 bits and nine 
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pixels are to be transferred per line, two bytes must be written per line, with the upper 7 bits of the 
second byte padded. In general, the number of padding bits per line will vary from 0 to (n-l), where n 
is the transfer width in bits. 

With a transfer width of 8 bits, the number of byte writes required per line can be determined from the 
formula n = (W+7)/8, with n being truncated to an integer if the result contains a fraction. Thus a 13-bit 
pixel transfer requires {13+7)/8 = 2.5 = 2 bytes. This is then multiplied by the height of the image (in 
pixels) to determine the COUNT of bytes to be transferred. Similar procedures apply to every other 
combination of the variables affecting the COUNT. The formulas for all cases are given below, where 
W Is the width of the image and H is the height of the image, both In pixels. 

8-bit transfers: COUNT = (W+7)/8 * H bytes {9AE8H_10-9 = 00b) 

16-bit transfers: COUNT = (W+15)/16 * H words {9AE8H_10-9 = 01b) 

32-blt transfers: COUNT = {W+31)/32 * H dwords (9AE8H_10-9 = 10b) 

New 32-bit transfers: COUNT = (((W+7)/8*H)+3)/4 dwords (9AE8H_10-9 = 11b) 

The differences between the two 32-bit transfer options are: 

1. For 9AE8H_10-9 set to 10b, every line of the transfer must start with a fresh doubleword. In other 
words, all unneeded bits in a doubleword transfer for a given line are discarded. After a rectan¬ 
gular image is transferred, the current drawing position is a the bottom left, meaning the next 
rectangle, if drawn, will be below the previous rectangle. 

2. For 9AE8H_10-9 set to 11b, only bits from the end of the line width to the next byte boundary are 
discarded. Data for the next line begins with the next byte. After a rectangular image is trans¬ 
ferred, the current drawing position is a the top right, meaning the next rectangle, if drawn, 

will be to the right of the previous rectangle. 

To write to a single plane, set the foreground mix to'logical one' {0002H),the background mix to 'logical 
zero' (0001H), and the Write Mask register (AAE8H) to select the desired (single) plane for updates. 
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Mono Pattern Case 1 (Source = Screen, Color Pixels) 

This command copies a source rectangular area in display memory to another location in display 
memory. It is identical to the Color Pattern Case 1 except that the Pattern Foreground and Background 
Colors registers are programmed, the Bitplane Read Mask register Is programmed to select the same 
bitplane enabled by the Bitplane Write Mask register when the pattern is written to memory and the 
mono pattern flag is set in the ROPMIX register. The Pixel Control register must be set to AOOOH to 
select the Foreground Mix register to specify the color source. The color source must be specified as 
the bitmap (screen). The 8x8 mono pattern must be copied to off-screen memory on an 8-bit horizontal 
boundary and its location specified. Bit 6 of the Command register must be set to 1 to specify X as the 
major axis. For this example, assume x1,y1 is the top left corner of the source rectangle In display 
memory and x2,y2 is the top left corner of the destination rectangle. The rectangles can be overlapping 
or disjoint. The height and width (in pixels) of the rectangle being copied are HEIGHT and WIDTH. 

Setup: 

First, the values of the Srcx, Srcy, Destx and Desty must be determined. 

Case 1: Source and destination rectangles do not overlap 

For X Positive, Y Positive: Srcx = x1, Srcy = y1, Destx = x2, Desty = y2 

Case 2: Source and destination rectangles overlap 

If x1 > x2 

then if X Positive, Srcx = x1, Destx = x2 

else 

Srcx = x1 + WIDTH -1, Destx = x2 + WIDTH -1 ; X Negative 

If y1 > y2 

then If Y Positive, Srcy = y1, Desty = y2 

else 

Srcy = y1 + HEIGHT -1, Desty = y2 + HEIGHT -1 ; Y Negative 


ES:[PIXEL_CNTL] <= AOOOH 
ES:[FRGD_MIX]<=006XH 
ES:[ROPMIX] <^01XXH 
ES:[PAT_FG_COLOR] <= 00000004H 
ES:[PAT_BG_COLORl <= OOOOOOOOH 
ES:[RD_MASK] ^ 00000001H 


; FRGD_MIX is the source of color source 
; color source is screen, mix type is ignored 
; mono pattern flag, XX = ROP code 
; foreground color index 4 
; background color Index 0 
; bitplane 0 enabled for reading 


Draw Operation: 


31 

ES:[ALT_PAT] <= 

15 

Patx 

0 

Paty 

; set starting coordinates for pattern 

ES:[ALT_CURXY] <:= 

31 

Srcx 

15 0 

Srcy 

; set starting coordinates 

31 

ES:[ALT_STEP] 4= [ 

15 

Destx 

0 

Desty 

; set destination coordinates 
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31_15_0 

ES:IALT_PCNT] <!= WIDTH-1 | HEIGHT-1 ; rectangle width and height 

ES:[CMD] <= IIOOIOOODODIOOOlb ; ROPBLT{bits 15-13, 11), always X Major (bit 6), draw (bit 4) 
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Mono Pattern Case 2 (Source = CPU, Color Pixels) 


This command transfers a rectangular image from the CPU to the display memory through the plane. 
It is identical to the Color Pattern Case 2 described earlier except that the Pattern Foreground and 
Background Colors registers are programmed, the Bitplane Read Mask register is programmed to select 
the same bitplane enabled by the Bitplane Write Mask register when the pattern is written to memory 
and the mono pattern flag is set in the ROPMIX register, "through the plane" means the complete color 
Index is transferred for each pixel, e.g., In 8 bits/pixel mode, one byte Is required to transfer one pixel 
to memory. The image is stored as an array of pixels arranged in row major fashion (consecutively 
increasing memory addresses). The Pixel Control register must be set to AOOOH to select the Fore¬ 
ground Mix register to specify the color source. The color source must be specified as the CPU. ROP 
codes without a source operand must not be used. The 8x8 mono pattern must be copied to off-screen 
memory on an 8-bit horizontal boundary and its location specified. Bit 12 of the Command register 
must be set to 1 (swap ON) for Intel-type architectures. Bit 8 of the Command register must be set to 
1 (wait for CPU data) and bits 6 and 5 must also be set to 1 to specify X as the major axis and a left-to-right 
drawing direction. For this example, x1,y1 is the top left corner of the rectangle on the screen. The 
height and width of the rectangle (in pixels) are HEIGHT and WIDTH. Doubiword CPU writes are 
supported by setting bits 10-9 of the Command register to 10b. 

Setup: 


ES:[PiXEL_CNTL] AOOOH 
ES:[FRGD_MIX] 004XH 
ES:[ROPMIX]4=01XXH 
ES:[PAT_FG_COLOR] 4= 00000004H 
ES:[PAT_BG_COLOR] <?= OOOOOOOOH 
ES:[RD_MASK] 4= 00000001H 


; FRGD_MIX is the source for color source 
; color source is the CPU, mix type Is ignored 
; mono pattern flag, XX = ROP code 
; foreground color index 4 
; background color index 0 
; bitplane 0 enabled for reading 


Drawing Operation: 

31 15 

ES:[ALT_PAT1 <=| Patx 


Paty 


31 15 0 


ES:[ALT_STEP] <?= 

Xl 

y1 

31 

15 0 

ES:[ALT_PCNT] <= 

WIDTH-1 

HEIGHT-1 


; set starting coordinates for pattern 
; set destination starting coordinates 
; rectangle width 


Wait for Graphics Engine not busy ; loop till bit 9 of 9AE8H register Is 0 
ES:[CMD] 11001101D0110001b ; ROPBLT (bits 15-13, 11), swap ON (bit 12), 

; 32-bit transfers (bits 10-9), wait for CPU data (bit 8), 

; always X Major (bit 6) & X Positive (bit 5), draw (bit 4) 


COUNT (of image pixel data to transfer) = (See Note) 

PIX_TRANS IMAGEDATA; Output image data to the Pixel Data Transfer registers for COUNT dwords. 


Note 


The COUNT of the number of writes required by the CPU is a function of the number of pixels to be 
transferred, the width of the transfer (8,16 or 32 bits as specified by bits 10-9 of the Drawing Command 
register (9AE8H)) and the color depth (bits/pixel). The number of pixels transferred per line must be an 
even multiple of the transfer width. If this is not the case, the last write per line must be padded with 
one or more dummy pixels to meet this requirement. For example, at 4 bits/pixel, each byte holds two 
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pixels. If the transfer width is one byte and three pixels are to be transferred per line, two bytes must 
be written per line, with the upper nibble of the second byte a dummy pixel. If the transfer width is 16 
bits, from one to three dummy pixels may be required to make the number of pixels per line an even 
multiple of 16. The number of word writes required per line can be determined from the formula n = 
{W+3)/4, with n being truncated to an integer If the result contains a fraction. Thus a six pixel transfer 
requires (6+3)/4 = 2.25 = 2 words. This is then multiplied by the height of the the image (in pixels) to 
determine the COUNT of words to be transferred. Similar procedures apply to every other combination 
of the variables affecting the COUNT. The formulas for all cases are given below, where W is the width 
of the Image and H is the height of the Image, both in pixels. 

COUNT for 4 bits/pixel modes 

8-bit transfers: COUNT = (W+1)/2 * H bytes 
16-bit transfers: COUNT = (W+3)/4 * H words 
32-bit transfers: COUNT = (W+7)/8 * H dwords 

COUNT for 8 bits/pixel modes 

8-bit transfers: COUNT = W * H bytes 
16-blt transfers: COUNT = (W+1)/2 * H words 
32-blt transfers: COUNT = {W+3)/4 * H dwords 

COUNT for 16 bits/pixel modes 

8-bit transfers: Do not use this combination 
16-bit transfers: COUNT = W * H words 
32-bit transfers: COUNT = (W+1)/2 * H dwords 

COUNT for 32 bits/pixel modes 

8-bit transfers: COUNT = Do not use this combination 
16-bit transfers: COUNT = 2W * H words 
32-bit transfers: COUNT = W * H dwords 
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Mono Pattern Case 3 (Source = CPU, Mono Pixels) 

This command transfers a rectangular image from the CPU to the display memory across the plane. It 
is identical to the Color Pattern Case 3 described earlier except that the Pattern Foreground and 
Background Colors registers are programmed, the Bitplane Read Mask register is programmed to select 
the same bitplane enabled by the Bitplane Write Mask register when the pattern is written to memory 
and the mono pattern flag is set in the ROPMIX register, "across the plane" means that each bit sent 
by the CPU is stored in display memory as a single pixel. These pixels are arranged in row majorfashion 
(consecutively Increasing memory addresses). An "across the plane" transfer Is created by (1) setting 
bits 7-6 of the Pixel Control register to A080H to specify the CPU as the source of the mask bit selecting 
the mix register, (2) specifying a background and foreground color, (3) setting bit 8 of the Command 
register (9AE8H) to 1 (wait for CPU data) and (4) setting bit 1 of the Command register to 1 (multi-pixel). 
ROP codes without a source operand must not be used. The 8x8 mono pattern must be copied to 
off-screen memory on an 8-bit horizontal boundary and its location specified. When the pattern bit sent 
by the CPU is a 1, the Foreground Mix register specifies the the color source and mix. When the bit is 
a 0, the Background Mix register specifies the color source and mix. For this example, x1,y1 is the top 
left corner of the rectangle on the screen. The height and width of the rectangle (in pixels) are HEIGHT 
and WIDTH. The monochrome image is translated so that pixels corresponding to a 1 in the bit image 
are given color index 4 and pixels corresponding to a 0 in the bit image are given color Index 0. This 
example uses word transfers from the CPU as specified by setting bits 10-9 of the Command register 
to 01b for a 16-bit bus width. 


ES:[ALT_MIX] 4= | 002XH | OOO: 

ES:[FRGD_COLOR] <= 00000004H 
ES:[BKGD_COLOR] OOOOOOOOH 
ES:[PIXEL_CNTL] 4= A080H 
ES:[ROPMIX]4=01XXH 
ES:[PAT_FG_COLOR] «= 00000004H 
ES:[PAT_BG_COLOR] <J= OOOOOOOOH 
ES:[RD_MASK] <= 00000001H 


^H_I ; FRGD_COLOR is color source 

; BKGD_COLOR is color source 
; foreground color Index 4 
; background color Index 0 

; selection of mix register Is based on data from the CPU 
; mono pattern flag, XX = ROP code 
; foreground color index 4 
; background color Index 0 
; bitplane 0 enabled for reading 


Drawing Operation: 

31_15_0 

ES:[ALT_PAT]<j=| Patx ^ Paty j 
ES:[ALT_STEP] 

ES:[ALT_PCNT] 



; set starting coordinates for pattern 
; set destination starting coordinates 
; rectangle width 


Wait for Graphics Engine not busy ; loop till bit 9 of 9AE8H register is 0 
CMD<J= IIOOIOIIDOIIOOIIb ; ROPBLT (bits 15-13, 11), swap ON (bit 12), 

; 16-bit transfers (bits 10-9), wait for CPU data (bit 8), 

; always X Major (bit 6) & X Positive (bit 5), draw (bit 4), 
; multi-pixel (bit 1) 


COUNT (of Image pixel data to transfer) = ((WIDTH +15)/16)*HEIGHT words 

P1X_TRANS 4= IMAGEDATA; Output image data to Pixel Transfer register for COUNT words 
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Notes 

The COUNT of the number of writes required by the CPU is a function of the number of pixels to be 
transferred and the width of the transfer (8,16 or 32 bits as specified by bits 10-9 of 9AE8H). Except for 
the case where bits 10-9 of 9AE8H are 11b, the number of pixels transferred per line must be an even 
multiple of the transfer width. If this is not the case, the last write per line must be padded with one or 
more dummy pixels to meet this requirement. For example, if the transfer width is 8 bits and nine 
pixels are to be transferred per line, two bytes must be written per line, with the upper 7 bits of the 
second byte padded. In general, the number of padding bits per line will vary from 0 to (n-1), where n 
is the transfer width in bits. 

With a transfer width of 8 bits, the number of byte writes required per line can be determined from the 
formula n = (W+7)/8, with n being truncated to an integer if the result contains a fraction. Thus a 13-bit 
pixel transfer requires (13+7)/8 = 2.5 = 2 bytes. This is then multiplied by the height of the image (in 
pixels) to determine the COUNT of bytes to be transferred. Similar procedures apply to every other 
combination of the variables affecting the COUNT. The formulas for all cases are given below, where 
W is the width of the image and H is the height of the image, both in pixels. 

8-blt transfers: COUNT = {W+7)/8 * H bytes (9AE8H_10-9 = 00b) 

16-bit transfers: COUNT = (W+15)/16 * H words {9AE8H_10-9 = 01b) 

32-bit transfers: COUNT = (W+31)/32 * H dwords (9AE8H_10-9 = 10b) 

New 32-bit transfers: COUNT = (((W+7)/8*H)+3)/4 dwords (9AE8H_10-9 = 11b) 

The differences between the two 32-bit transfer options are: 

1. For 9AE8H_10-9 set to 10b, every line of the transfer must start with a fresh doubleword. In other 
words, all unneeded bits in a doubleword transfer for a given line are discarded. After a rectan¬ 
gular image is transferred, the current drawing position is a the bottom left, meaning the next 
rectangle, if drawn, will be below the previous rectangle. 

2. For 9AE8H_10-9 set to 11 b, only bits from the end of the line width to the next byte boundary are 
discarded. Data for the next line begins with the next byte. After a rectangular image is trans¬ 
ferred, the current drawing position is a the top right, meaning the next rectangle, if drawn, 

will be to the right of the previous rectangle. 

To write to a single plane, set the foreground mix to 'logical one' {0002H), the background mix to 'logical 
zero' (0001H), and the Write Mask register {AAE8H) to select the desired (single) plane for updates. 
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5.4.3.19 Programmable Hardware Cursor 

A programmable cursor is supported which is compatible with the Microsoft Windows (bit 4 of CR55 
= 0) and X11 (bit 4 of CR55 = 1) cursor definitions. The cursor size is 64 pixels wide by 64 pixels high, 
with the cursor pattern stored in an off-screen area of display memory. Two monochrome images 64 
bits wide by 64 bits high (512 bytes per image) define the cursor shape. The first bit image is an AND 
mask and the second bit image is an XOR mask. The following is the truth table for the cursor display 
logic. 


AND Bit 

XOR Bit 

Displayed (Microsoft Windows) 

Displayed (X11) 

0 

0 

Cursor Background Color 

Current Screen Pixel 

0 

1 

Cursor Foreground Color 

Current Screen Pixel 

1 

0 

Current Screen Pixel 

Cursor Background Color 

_^_i 

1 

NOT Current Screen Pixel 

Cursor Foreground Color 


The hardware cursor color is taken from the Hardware Graphics Cursor Foreground Stack (CR4A) and 
the Hardware Graphics Cursor Background Stack (CR4B) registers. Each of these is a stack of three 8-bit 
registers. The stack pointers are reset to 0 by reading the Hardware Graphics Cursor Mode register 
(CR45). The color value Is then programmed by consecutive writes (low byte, second byte, third byte) 
to the appropriate (foreground or background) register. 

Enabling/Disabling the Cursor 

The hardware cursor is disabled when a VGA-compatible mode is in use. It can be enabled or disabled 
when in Enhanced mode (bit 0 of 4AE8H = 1), as follows. 


CR39 AOH 
CR45_0 1 

CR45_0 0 

CR39 4= OOH 


; Unlock System Control registers 
; Enable hardware cursor 
; Disable hardware cursor 
; Lock System Control registers 


Positioning the Cursor 

The cursor can be positioned at any point on the display, with the X,Y coordinates ranging from 0 to 
2047. This enables the full cursor images to be displayed on the screen and partial cursor images to 
be displayed at the right edge and the bottom edge of the screen. The cursor offset OX,OY has to be 
set to 0,0 for a 1024x768 resolution. If X Is > (1024 - 64) or Y is > (768 - 64), then a partial cursor is 
visible at the right edge or top edge of the screen respectively. Note that If Y > 768 then the cursor Is 
not visible; it is residing in the off-screen area. 

A partial cursor image can be displayed at the left edge or the top edge of the screen. To enable partial 
cursor display at the top edge of the screen, Y is set to 0 and the Y offset register is set to OY (range 
from 0 to 63). This displays the bottom 64-OY rows of the cursor image at the currently set X position 
and the top edge of the screen. Similarly, a partial cursor can be displayed at the left edge of the screen 
by setting X to 0 and the X offset register to OX (range from 0 to 63). This displays the right 64-OX 
columns of the cursor image at the currently set X and the left edge of the screen. The following 
pseudocode illustrates cursor positioning. 


CR39 ^ AOH ; Unlock System Control registers 

CR46_10-8 <^= MS 3 bits of X cursor position 
CR47_7-0 <j= LS 8 bits of X cursor position 
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CR49_7-0 ^ LS 8 bits of Y cursor position 
CR4E_5-0 4= Cursor Offset X position 
CR4F_5-0 Cursor Offset Y position 
CR48_10-8 <= MS 3 bits of Y cursor position 

CR39 ^ OOH ; Lock System Control registers 

The cursor position is updated by the hardware once each frame. Therefore, the programmer should 
ensure that the position is re-programmed no more than once for each vertical sync period. 

Programming the Cursor Shape 

The AND and the XOR cursor image bitmaps are 512 bytes each. These are stored in consecutive bytes 
of off-screen display memory, 512 AND bytes followed by 512 XOR bytes. The starting location must 
be on a 1024-byte boundary. This location is programmed into the Hardware Graphics Cursor Start 
Address registers (CR4C and CR4D) as follows: 

CR39 <= AOH ; Unlock System Control registers 

CR4C_5-8 <^= MS 4 bits of the cursor storage start 1024-byte segment. 

CR4D <= LS 8 bits of the cursor storage start 1024-byte segment 
CR39 <= 0 ; Lock System Control registers 

The value programmed is the 1024-byte segment of display memory at which the beginning of the 
hardware cursor bit pattern is located. For example, for an 800x600x8 mode on a 1 MByte system, 
there are 10241K segments. Programming CR4C_11-8 with 3H and CR4D with FEH specifies the starting 
location as the 1022nd (0-based) IK segment. The cursor pattern is programmed (using linear 
addressing) at FF800H offset from the base address of the frame buffer. 

Note 

If the cursor is not 64 bits by 64 bits, the given images should be padded to make the cursor image 64 
bits by 64 bits. The padded area should be made transparent by padding the extra AND mask bits with 
'Vs and the extra XOR bits by 'O's. 

5.5 RECOMMENDED READING 

Graphics Programming for the 8514/A by Jake Richter and Bud Smith (M&T Publishing, Inc) provides 
extensive explanations and examples for programming most of the bits in the S3 Enhanced Registers. 

Although not released at the time this data book was printed, the 3rd edition of Programming Guide 
to the EGA and VGA Cards by Richard F. Ferraro (Addison-Wesley Publishing Company, Inc) is 
scheduled to include a section on programming for S3 accelerator chips. 
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Section 6: Video Engine 


This section describes the Video Engine provided 
by the Vision968. The Video Engine registers are 
described in Section 2. 

6.1 VIDEO ENGINE OVERVIEW 

The Video Engine obtains pixel data either from 
video memory or the CPU, operates on it and 
then writes to display memory. Particular pixels 
in memory can be masked off from being up¬ 
dated by the video data. The operations the Video 
Engine can perform are scaling (both horizontal 
and vertical), color space conversion (YUV to 
RGB) and dithering (reduce color depth from 24 
bits/pixel to 16, 15 or 8 bits/pixel). The legal 
input/output combinations are shown in Table 


6-1. The Input and output bit settings are for 
8088H_22-20 and 8088H_18-16 respectively. 

The Video Engine processes one pixel per MCLK 
regardless of the pixel depth. Input and output 
FIFOs allow burst/block transfers from and to 
memory to improve throughput. 

New MMIO operation (bits 4-3 of CR53 set to 11 b) 
is required for Video Engine access. If big endian 
addressing is required, bits 2-1 of CR53 control 
byte swapping. 

The Video Engine cannot be used when the 
Vision968 is being operated in packed 24 
bits/pixel mode (bits 5-4 of CR50 set to 10b). It 
does not take advantage of 1-cycle EDO memory 
operation if this is specified (bits 3-2 of CR36 set 


Table 6-1 Video Engine Input/Output Combinations 




Output 

000 

oil 

100 

101 

110 

111 


Width 


8 

32 

16 

16 

16 

16 

Input 


Format 

RGB332 

RGB888 

YC/ 

YUV442 

raw 

RGB555 

RGB565 

000 

8 

RGB332 

S 

No 

No 

No 

No 

No 

Oil 

32 

RGB888 

S/D 

S 

No 

No 

S/D 

S/D 

100 

16 

YC/YUV 

422 

S/C/D 

S/C 

S 

No 

S/C/D 

S/C/D 

101 

16 

raw 

No 

No 

No 

S 

No 

No 

110 

16 

RGB555 

S/D 

S 

No 

No 

S 

S 

111 

16 

RGB565 

S/D 

S 

No 

No 

S 

S 


S = Scaling 

C = Color Space Conversion 
D = Dithering 
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to 11b. Instead, it will use standard fast page or 
EDO cycles. 

The Video Engine and the Graphics Engine must 
not be in use at the same time. To ensure this, 
the Video Engine NOP register (8080H) must be 
written to after all Video Engine data/commands 
have been written. Similarly, a Graphics Engine 
NOP must be executed after a Graphics Engine 
access before the Video Engine can be written to 
again. 

6.2 SCALING 

Bit 31 of 808CH is cleared to 0 to specify a stretch 
and set to 1 to specify a shrink. Bit 30 of 808CH is 
cleared to 0 to specify display memory as the 
data source and set to 1 to specify the CPU as the 
data source. If display memory is the data source, 
the starting address for the data is specified in 
8098H. The amount of stretch or shrink Is speci¬ 
fied by programming source and destination 
steps In 8090H and also programming the follow¬ 
ing DDA parameters. 

The Internal digital differential analyzer (DDA) is 
programmed by specifying the DDA accumulator 
Initial value in bits 11-0 of 8088H and the K1 and 
K2 constants via bits 10-0 and 26-16 of 808CH. 

The input data format is specified via bits 22-20 
of 8088H. If 100b Is specified, bit 19 of 8088H is 
cleared to 0 to specify YCbCr and set to 1 to 
specify YUV. 

Asingle pass through the Video Engine produces 
a one-dimensional stretch or shrink (horizontal or 
vertical). This can be written directly to on-screen 
memory. A two-dimensional scaling requires 
two passes. The first pass writes the one-dimen- 
sionally scaled data to off-screen memory. The 
second pass BitBLTs the off-screen image to on¬ 
screen memory while performing the scaling in 
the other dimension. Both the amount of scaling 
and the dimension (horizontal or vertical) are 
controlled by the step constants programmed 
into 8090H. 

Vertical scaling requires much more bandwidth 
than horizontal scaling. Therefore, vertical scal¬ 
ing should be done during the first pass and 
horizontal scaling during the second pass for 


stretching. The reverse is true for shrinking the 
image. 

If filtering is required, it is enabled via bit 31 of 
8088H. The type of filtering Is specified via bits 
15-14 of 808CH. 

The output data format is specified via bits 18-16 
of 8088H. If the output is 8 bits/pixel RGB, setting 
bit 28 of 8088H to 1 palettizes the data, i.e., each 
byte is a color look up table (LUT) address. This 
output protects the upper and lower 10 LUT slots, 
which are used for system colors. Therefore, it 
maps certain adjacent pairs of data values to the 
same LUT address so that all 256 values generate 
a non-protected color. 

The output can be cropped by specifying a start 
value and length in 8094H. Alternately, the output 
can be masked against a mask pattern stored in 
main (system) memory. This is enabled by set¬ 
ting bit 26 of 8088H to 1. The mask contains one 
bit for each pixel in on-screen memory. The mask 
data must be sent by the CPU just prior to proc¬ 
essing of the relevant screen pixels. 

If bit 29 of 808CH Is cleared to 0, a bit value of 1 
in the mask allows the video to overwrite the 
graphics pixel and a value of 0 protects the graph¬ 
ics pixel from being overwritten. If this bit Is set 
to 1, the effect is reversed. 

6.3 COLOR SPACE CONVERSION 

Either YUV or YCbCr 4-4-2 input can be converted 
to RGB format. YUVA'CbCr input is selected by 
setting bits 22-20 of 8088Hto 100b. YUV or YCbCr 
is selected via bit 19 of 8088H (YUV = 1; YCbCr = 
0). The output data format is selected via bits 
18-16 of 8088H. This can be RGB-8 (=000b), RGB- 
15 (=110b), RGB-16 (=111b) or RGB-32 (=011b). 

YUV/YCbCr data can be scaled before it is con¬ 
verted. If two pass scaling is being performed, 
color space conversion should be done during 
the horizontal pass. 

6.4 DITHERING 

If the bits/pixel (color depth) of the data in display 
memory is less than the input data (or the gener- 
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ated output of a color space conversion), the data 
must have its color depth reduced to match that 
used in display memory. This is called dithering. 
24 bits/pixel can be dithered to 16, 15 or 8 
bits/pixel. 16 or 15 bits/pixel can be dithered to 8 
bits/pixel. 

When the final output Is 8 bits/pixel, the pixel 
value is an index Into a 256 position color look up 
table (LUT). Windows uses the top and bottom 
10 colors for Its system colors. To avoid overwrit¬ 
ing these colors, the Video Engine maps its 256 
color values Into the 236 LUT positions not used 
by Windows. The lost color values are spread 
evenly over the range to minimize the effect. 

Dithering Is enabled by setting bit 29 of 8088H to 
1. The dithering matrix Index must be pro¬ 
grammed via bits 25-23 of 8088H. 

Dithering is done after scaling and color space 
conversion. As with color space conversion, it 
should be done in the horizontal pass of a two 
pass scaling operation. 

6.5 STATUS 

Bit 31 of 809CH is read-only. When set to 1, It 
indicates the Video Engine is in use. 
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Appendix A: Listing of Raster Operations 


The Vision968 supports all 256 triadic raster op¬ 
erations (ROPs) for BitBLTs as defined by 
Microsoft for Windows. The coding for these is 
found on the following pages. 

The HEX value in the first column is the ROP 
code. This value must be programmed into bits 
7-0 of D2E8H atthetimethata ROPBLTcommand 
is executed. 

The effect of the ROP is shown in reverse Polish 
notation in the second column. This is interpreted 
as follows: 

S = Source bitmap 

P = Pattern 

D = Destination bitmap 

The source bitmap can be either the CPU or the 
current screen, as selected via bits 6-5 of either 
A2E8H or A6E8H. A CPU source can be either 
monochrome or color. A screen source is always 
color. 

The pattern, if present, is found at the off-screen 
memory location specified by EAE8H and 
EAEAH. The pattern may be either monochrome 
or color, as specified by bit 8 of D2E8H. If the 
pattern is monochrome, its background color is 
specified by E6E8H and its foreground color by 
EEE8H. 

The destination bitmap is always the screen. It is 
always color (as opposed to monochrome). 


The boolean operators used as as follows: 

o = bitwise OR 

X = bitwise EXCLUSIVE OR 

a = bitwise AND 

n = bitwise NOT (inverse) 

For example, ROP 16H is PSDPSanaxx. The pat¬ 
tern is first ANDed with the source 
[PSD(PaS)naxx]. The result is Inverted and then 
ANDed with the destination [PS((Da(notPaS))xx. 
This result is EXCLUSIVE ORed with the source. 
Finally, the result of this is EXCLUSIVE ORed with 
the pattern. 

Programming using ROPBLTs is explained In En¬ 
hanced Mode Programming section. 


LISTING OF RASTER OPERATIONS A-1 




S3 Vision968 Multimedia Accelerator 


S3 Incorporated 


HEX 

In Reverse Polish 

1 00 

0 

1 01 

DPSoon 

02 

DPSona 

I 03 

PSon 

I 04 

SDPona 

I 05 

DPon 

i 06 

PDSxnon 

I 07 

PDSaon 

I 08 

SDPnaa 

i 09 

PDSxon 

I OA 

DPna 

I OB 

PSDnaon 

I 00 

SPna 

I OD 

PDSnaon 

I OE 

PDSonon 

I OF 

Pn 

i 10 

PDSona 

I 11 

DSon 

i 12 

SDPxnon 

1 13 

SDPaon 

1 14 

DPSxnon 

i 15 

DPSaon 

1 16 

PSDPSanaxx 

17 

SSPxDSxaxn 

18 

SPxPDxa 

1 19 

SDPSanaxn 

1 1A 

PDSPaox 

; IB 

SDPSxaxn 

i 1C 

PSDPaox 

1 ID 

DSPDxaxn 

1 IE 

PDSox. 

1 IF 

PDSoan 

1 20 

DPSnaa 

! 21 

SDPxon 

1 22 

DSna 

1 23 

SPDnaon 

: 24 

SPxDSxa 

25 

PDSPanaxn 

26 

SDPSaox 

27 

SDPSxnox 

28 

DPSxa 

1 29 

PSDPSaoxxn 

! 2A 

DPSana 

! 2B 

SSPxPDxaxn 


i HEX 

In Reverse Polish 

1 20 

SPDSoax 

i 2D 

PSDnox 

2E 

PSDPxox 

2F 

PSDnoan 

30 

PSna 

1 31 

SDPnaon 

t 32 

SDPSoox 

i 33 

Sn 

■ 34 

SPDSaox 

35 

SPDSxnox 

36 

SDPox 

. 37 

SDPoan 

38 

PSDPoax 

39 

SPDnox 

. 3A 

SPDSxox 

1 3B 

SPDnoan 

1 30 

PSx 

i 3D 

SPDSonox 

1 3E 

SPDSnaox 

1 3F 

PSan 

i 40 

PSDnaa 

1 41 

DPSxon 

I 42 

SDxPDxa 

43 

SPDSanaxn 

44 

SDna 

45 

DPSnaon 

: 46 

DSPDaox 

I 47 

PSDPxaxn 

I 48 

SDPxa 

i 49 

PDSPDaoxxn 

4A 

DPSDoax 

4B 

PDSnox 

40 

SDPana 

4D 

SSPxDSxoxn 

I 4E 

PDSPxox 

I 4F 

PDSnoan 

i 50 

PDna 

! 51 

DSPnaon 

I 52 

DPSDaox 

I 53 

SPDSxaxn 

I 54 

DPSonon 

I 55 

Dn 

I 56 

DPSox 

I 57 

DPSoan 
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HEX 

In Reverse Polish 

58 

PDSPoax 

i 59 

DPSnox 

^ 5A 

DPx 

! 5B 

DPSDonox 

1 50 

DPSDxox 

1 5D 

DPSnoan 

1 5E 

DPSDnaox 

i 5F 

DPan 

60 

PDSxa 

61 

DSPDSaoxxn 

I 62 

DSPDoax 

I 63 

SDPnox 

i 64 

SDPSoax 

i 65 

DSPnox 

I 66 

DSx 

I 67 

SDPSonox 

i 68 

DSPDSonoxxn 

^ 69 

PDSxxn 

I 6A 

DPSax 

i 6B 

PSDPSoaxxn 

60 

SDPax 

6D 

PDSPDoaxxn 

6E 

SDPSnoax 

6F 

PDSxnan 

70 

PDSana 

71 

SSDxPDxaxn 

72 

SDPSxox 

73 

SDPnoan 

74 

DSPDxox 

75 

DSPnoan 

76 

SDPSnaox 

77 

DSan 

78 

PDSax 

79 

DSPDSoaxxn 

7A 

DPSDnoax 

i 7B 

SDPxnan 

1 70 

SPDSnoax 

1 7D 

DPSxnan 

i 7E 

SPxDSxo 

1 7F 

DPSaan 

;! 80 

DPSaa 

1 81 

SPxDSxon 

i 82 

DPSxna 

i 83 

SPDSnoaxn 


HEX 

In Reverse Polish 

! 84 

SDPxna 

1 85 

PDSPnoaxn 

1 86 

DSPDSoaxx 

1 87 

PDSaxn 

88 

DSa 

89 

SDPSnaoxn 

8A 

DSPnoa 

1 8B 

DSPDxoxn 

1 80 

SDPnoa 

i 8D 

SDPSxoxn 

1 8E 

SSDxPDxax 

^ 8F 

PDSanan 

1 90 

PDSxna 

i 91 

SDPSnoaxn 

1 92 

DPSDPoaxx 

1 93 

SPDaxn 

1 94 

PSDPSoaxx 

i 95 

DPSaxn 

1 96 

DPSxx 

S 97 

PSDPSonoxx 

! 98 

SDPSonoxn 

1 99 

DSxn 

1 9A 

DPSnax 

1 9B 

SDPSoaxn 

i 90 

SPDnax 

1 9D 

DSPDoaxn 

i 9E 

DSPDSaoxx 

9F 

PDSxan 

1 AO 

DPa 

1 A1 

PDSPnaoxn 

1 A2 

DPSnoa 

1 A3 

DPSDxoxn 

j A4 

PDSPonoxn 

1 A5 

PDxn 

1 A6 

DSPnax 

1 A7 

PDSPoaxn 

i A8 

DPSoa 

1 A9 

DPSoxn 

1 AA 

D 

1 AB 

DPSono 

! AC 

SPDSxax 

1 AD 

DPSDaoxn 

i AE 

DSPnao 

^ AF 

DPno 
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HEX 

In Reverse Polish 

DC 

SPDnao 

DD 

SDno 

DE 

SDPxo 

1 DF 

SDPano 

! EO 

PDSoa 

! E1 

PDSoxn 

I E2 

DSPDxax 

i E3 

PSDPaoxn 

i E4 

SDPSxax 

I E5 

PDSPaoxn 

I E6 

SDPSanax 

I E7 

SPxPDxan 

I E8 

SSPxDSxax 

I E9 

DSPDSanaxxn 

I EA 

DPSao 

: EB 

DPSxno 

EC 

SDPao 

ED 

SDPxno 

i EE 

DSo 

I EF 

SDPnoo 

I FO 

P 

I F1 

PDSono 

F2 

PDSnao 

F3 

PSno 

F4 

PSDnao 

F5 

PDno 

F6 

PDSxo 

F7 

PDSano 

F8 

PDSao 

. F9 

PDSxno 

I FA 

DPo 

I FB 

DPSnoo 

: FC 

PSo 

I FD 

PSDnoo 

I FE 

DPSoo 

^ FF 

1 


HEX 

In Reverse Polish 

BO 

PDSnoa 

B1 

PDSPxoxn 

B2 

SSPxDSxox 

B3 

SDPanan 

B4 

PSDnax 

B5 

DPSDoaxn 

B6 

DPSDPaoxx 

B7 

SDPxan 

B8 

PSDPxax 

B9 

DSPDaoxn 

BA 

DPSnao 

I BB 

DSno 

i BC 

SPDSanax 

BD 

SDxPDxan 

BE 

DPSxo 

I BF 

DPSano 

I CO 

PSa 

I 01 

SPDSnaoxn 

I 02 

SPDSonoxn 

I 03 

PSxn 

i 04 

SPDnoa 

^ 05 

SPDSxoxn 

I 06 

SDPnax 

: 07 

PSDPoaxn 

I 08 

SDPoa 

: 09 

SPDoxn 

I CA 

DPSDxax 

I CB 

SPDSaoxn 

I CO 

s 

^ CD 

SDPono 

I CE 

SDPnao 

I OF 

SPno 

; DO 

PSDnoa 

I D1 

PSDPxoxn 

1 D2 

PDSnax 

1 D3 

SPDSoaxn 

1 D4 

SSPxPDxax 

1 D5 

DPSanan 

1 D6 

PSDPSaoxx 

D7 

DPSxan 

D8 

PDSPxax 

I D9 

SDPSaoxn 

1 DA 

DPSDanax 

i DB 

SPxDSxan 
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